Getting started

Install

1. Download Bloom and open the disk image.
2. Drag Bloom into your Applications folder, then open it from there.
3. The welcome window walks you through the rest: paste the license key from your purchase email, then allow Accessibility access.

Bloom needs macOS 14 Sonoma or later. It lives in your menu bar and stays out of the Dock.

Allow Accessibility access

To press shortcuts in other apps, macOS requires you to allow Bloom under Privacy & Security. Bloom uses this only to send the actions you pick. It never reads your keystrokes or your screen.

1. Open System Settings → Privacy & Security.
2. Choose Accessibility. On macOS 27 this section is called Device Control and Data Access.
3. Turn on the switch next to Bloom. If Bloom isn't listed, click + and choose it from Applications.

The welcome screen opens the right pane for you and notices as soon as the switch is on.

Using the button

• Click the button to open your menu. Click outside the menu or press Esc to close it.
• Drag it anywhere. When you let go it glides to the nearest edge or corner and stays there, even after a restart.
• Scroll over it to change the volume, and right-click it for the Accessibility Shortcuts panel. You can change both.
• Four seconds after you use it, the button fades to its idle opacity. Move the pointer over it and it's back.

Customize your menu

Open Settings from Bloom's menu bar icon, or tap Customize under the menu.

• Menus: pick a menu on the left (your Mac menu, or any app's), then edit it on a live preview of the real thing. Click an action to change its action, icon or label, tap + to add one, and drag rows in the list to reorder. Actions can be any of the 98 built-in ones, a keyboard shortcut you record, an app, a link, a Shortcut from the Shortcuts app, or a folder with more actions inside.
• Button: color, size and idle opacity with a live preview, and what click, double-click, long press, right-click and scroll do.
• General: open at login, the menu bar icon, a keyboard shortcut that opens the menu, backup, and your license.

Using the menu

• When an app has its own menu, tabs at the top of the menu show App | Mac. Tap Mac (or press Tab) for your everyday Mac menu, in any app.
• Every menu is a full grid of nine. Your picks come first, then what you use most, then essentials.
• Tap All actions at the bottom, or just start typing, to browse every action by category. Search understands everyday words (“make window bigger”), and with Apple Intelligence on, whole sentences. Press Return to run the first match, or ⌘I for details.
• Press and hold the button for a ring of your recent and most-used actions. Slide to one and let go.

Prefer to sketch it first? The free Menu Builder exports a file you can import.

Menus for each app

Bloom can swap its menu for the app in front. It comes with menus for Finder, Safari, Chrome, Xcode, VS Code, Figma, Keynote and Final Cut Pro, plus AI tools: the Claude and ChatGPT apps (where Codex lives), and Terminal, iTerm2, Ghostty and Warp for Claude Code and Codex CLI. The app's icon and name appear in the tabs at the top of the menu, so you always know which one is open. In Settings → Menus you can edit them, delete them, or add a page for any other app. If no page matches the app in front, Bloom shows your default menu.

Back up and move your setup

In Settings → General, under Backup, choose Export… to save everything (menus, app pages and button settings) to a .bloomconfig file. Use Import… on another Mac to load it. Importing replaces the current setup.

Troubleshooting

Actions don't do anything

Accessibility access is almost always the cause. Check the switch in Privacy & Security. If it's already on, turn it off and on again. After an update, macOS sometimes needs this refresh.

If that doesn't help, reset the permission in Terminal and allow it again:

tccutil reset Accessibility com.mayank.bloom

I can't find the button

It may be on another display, or faded to a low idle opacity in a corner. Choose Open Menu from Bloom's menu bar icon to use it right away, or quit Bloom and open it again from Applications.

A shortcut works on its own but not from Bloom

Some apps ignore shortcuts while a text field has focus, and a few system shortcuts can be turned off in System Settings → Keyboard → Keyboard Shortcuts. Make sure the shortcut is enabled there.

Uninstall

Quit Bloom from its menu bar icon and drag it from Applications to the Trash. To remove your settings too, delete the Bloom folder in ~/Library/Application Support, and remove Bloom from the Accessibility list in System Settings.

Still stuck? Email hello@mayankbuilds.com.