M-Bar Launcher help

Answers to your questions about M-Bar Launcher on the Mac

🔍

No articles matched your search. Try different keywords or contact support.

Installation

Installing on macOS

M-Bar Launcher ships as a notarized DMG signed with a Developer ID, so it opens without a Gatekeeper warning. Download the .dmg, open it, and drag the app into your Applications folder.

  1. Download M-Bar-Launcher.dmg and open it.
  2. Drag M-Bar Launcher into your Applications folder.
  3. Launch the app from Applications. No Gatekeeper warning appears, because the app is notarized.
  4. You only need to do this once. Every subsequent launch works normally.

Requires macOS 13 (Ventura) or later on Apple Silicon or Intel.

Adding items

Open Settings from the popover gear icon, then click + Add Item and choose a type:

  1. App: pick any .app bundle from /Applications or elsewhere.
  2. .command: select a .command shell script, M-Bar Launcher opens it in Terminal on click.
  3. Shell: type an inline command (e.g. git -C ~/project pull) that runs via osascript when the item is clicked.

Organizing

In the Settings window, drag-handle the left edge of any row to reorder. The 3-dot menu on each row offers Rename, Duplicate, Edit and Delete. Changes apply to the popover immediately, no restart needed.

Persistence

Launcher items are stored per-Mac in UserDefaults under the app's bundle identifier. They survive restarts, sleep/wake, and app reinstalls (as long as the bundle ID stays the same).

Items are not synced across Macs. If you want the same list on another Mac, export via Settings → Export and import on the other machine.

Troubleshooting

If a .command file or shell item does nothing on click, macOS is probably blocking it. Check System Settings → Privacy & Security → Automation and make sure M-Bar Launcher is allowed to control Terminal and System Events. For .command files, also verify the file is executable (chmod +x).

M-Bar Launcher runs as an .accessory app, it has no Dock icon, only an NSStatusItem in the menu bar. If the icon disappears, your menu bar is probably full and macOS is hiding it (common on MacBooks with a notch). Hide some other icons or use Bartender/Ice to reveal it. Force-quitting and relaunching the app also re-adds the status item.

Email info@toz.red with your macOS version, app version, and a description of the issue.