Help Center

Everything you need to know about M-Bar Launcher

🔍

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

Installation

Installing on macOS

M-Bar Launcher ships as a signed but not-yet-notarized DMG. On first launch macOS Gatekeeper will ask you to verify.

  1. Download M-Bar-Launcher.dmg and open it.
  2. Drag M-Bar Launcher into your Applications folder.
  3. Right-click the app in /Applications and choose Open. You will see a warning — click Open in the dialog.
  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.