A small macOS app for Facebook Messenger, a direct replacement for the old Messenger app for Mac. It opens facebook.com/messages in its own window, with shortcuts, mute and a menu bar icon.
Unofficial. Not made by or linked to Meta. May break when Facebook changes its site.
messageBae opens Messenger in its own window and tweaks the page locally with a little JavaScript. There's no server in the middle: your Mac connects straight to Meta's servers, the same as a browser tab.
- A real Mac app in your Dock, no browser needed
- Stays logged in between launches
- Native Mac notifications
- Small and light
- No tracking, analytics or servers of its own
Download the .dmg from the latest release, open it and drag messageBae into Applications. It's signed and notarised by Apple for your security.
messageBae checks for a new version on launch and every 12 hours, or use messageBae > Check for Updates….
- Free: download the new
.dmg, quit messageBae, drag it into Applications and choose Replace. Your settings stay. - Supporters: donate any amount. The thank you page shows a supporter code. Choose messageBae > Turn On Auto Update…, pick Enter Code… and paste it in. New versions download and install themselves, you just restart when asked.
The code is the same for everyone and only its hash is in the app. It's a small gate, not a licence check, so please donate before using it. Donations help cover the Apple developer account, domain and hosting.
Only if you know your way around the command line. Most people should use the release above.
Needs macOS and Node.js 20+.
git clone https://github.com/jchin14/messageBae.git
cd messageBae
npm install
npm startBuild the app with npm run dist. It bumps the version first, then builds into dist/.
Keep your hands on the keyboard. The shortcuts work like the ones you know from iMessage and other Mac apps, so there's nothing new to learn.
TL;DR
- Cmd+K find a chat, Cmd+L start typing
- Cmd+1-9 jump straight to a chat, Ctrl+Tab / Ctrl+Shift+Tab next / previous chat
- Cmd+U attach a photo or file (drag and drop still works too)
- Click anywhere in a chat to start typing
- Cmd+Shift+M toggle mute, Cmd+N toggle notify mode, Cmd+B clear badge
- Swipe with two fingers to reply, double-click or hold to react, like on your phone
| Key | Does |
|---|---|
| Cmd+K | Search chats |
| Enter in search | Open the top result and jump to the message box |
| Cmd+L | Go to message box |
| Cmd+U | Attach a photo or file (or drag and drop) |
| Cmd+B | Clear the badge count |
| Cmd+N | Toggle notify mode (!) |
| Cmd+Shift+M | Toggle mute |
| Cmd+1-9 | Open chat 1-9 |
| Ctrl+Tab / Ctrl+Shift+Tab | Next / previous chat |
| Esc ×2 | Clear the current line |
| Esc ×3 | Clear the whole message |
| Hold Esc | Leave full screen |
| Two-finger swipe sideways on a message or image | Reply to it |
| Double-click or hold a message | React to it |
| Click anywhere in a chat (not an image or button) | Start typing (jumps to the message box) |
:name |
Emoji list (Enter/Tab picks, Esc closes). :fire: swaps straight away |
- + attaches a photo or file (also Cmd+U).
- ✓ clears the badge count. New messages count up from 0.
- ! brings the window to the front when a message comes in.
- 🔔 mutes notifications and sounds (shows a red 🔕 when on).
- ↻ reloads Messenger.
- Only one of ! and 🔔 can be on at a time.
- Source: Messenger's web notifications, messageBae's own, or Off.
- Sound: Default, None, any macOS sound, or Choose File… for your own. Picking one plays a preview.
- Silence Messenger's Pop Sound stops the in-page pop, so only your sound plays.
- The window stays put if Messenger tries to scroll it (like clicking a quoted reply).
- If it ever shifts, a Reset view button shows bottom right. Click to reset, Shift-click to reload.
- If you open a profile or other Facebook page from a chat, a Back to Messenger button shows bottom right.
- Voice and video calls don't work yet.
- Clicking a quoted message in a reply makes the screen jump briefly. Messenger scrolls the window up and messageBae moves it straight back. This can't be avoided.
- Resize the window like any Mac app. Messenger's own buttons (share, view profile and so on) all work.
- With both window options set, Restore Window Size After Close wins.
- If the saved monitor isn't connected, the window opens at the default size.
- Drag the edge of the chat list or the info panel to resize it.
- Double-click the edge to reset.
- Widths are saved between launches.
- Reply on any message or image.
- Unsend on your own messages and images, with a small Mac popup to confirm in place of Messenger's big one (also from Messenger's own ⋯ menu).
- Spelling on a misspelled word: macOS suggestions and Add to Dictionary.
- Copy Message copies the whole message. Copy copies selected text.
- On images: copy or save.
The app menu, right-click menus and confirmations (unsend, updates, the supporter code) are native Mac menus and sheets, not web popups.
- All links, Facebook ones included, open in your default browser.
- Opens in front, unless you switch to another app while it loads. Then it waits in the background.
- Closing the window (Cmd+W) hides it. Cmd+Q quits.
In the View menu:
- Clear Badge: reset the unread count to 0
- Show Badge Count: on/off
- Show Menu Bar Icon: on/off
- Restore Window Size After Close: opens where you last left it
- Save Current Window Size and Position for Launch: opens at this size, on this monitor
- Forget Saved Window Size: back to the default
- Open in Background on Launch: start hidden
Change shortcuts with Edit Settings… (Cmd+,), then Reload Settings. The file is
~/Library/Application Support/messageBae/settings.json.
Found a bug or something not working? Open an issue on GitHub.
If you find this useful and can afford to, support is appreciated: buy me a coffee. Just getting started, the domain, hosting, Cloudflare Workers and Apple and Google developer accounts add up to a few hundred dollars. Your support helps me keep making tools that are helpful for everyone.
PolyForm Noncommercial 1.0.0. Free for personal use. Any redistribution, or use in a commercial setting, needs my OK first: email [email protected] or open an issue.