midi-harbor/specs/015-mac-menus/contracts/menus.md
2026-09-28 13:59:10 -05:00

71 lines
2.1 KiB
Markdown

# Contract: the menus on macOS
Both builds. What differs in App Store mode is marked; its menu bar item is in
[014's contract](../../014-mac-app-store-mode/contracts/menus.md).
**Midi Harbor**
| Item | Shortcut | Does |
|---|---|---|
| About Midi Harbor | | The standard About panel |
| — | | |
| Settings… | ⌘, | Shows the Settings page |
| — | | |
| Services | | The standard Services menu |
| — | | |
| Close to Menu Bar | ⌘Q | App Store mode only: hides the window and the Dock icon |
| Hide Midi Harbor | ⌘H | The standard Hide |
| Hide Others | ⌥⌘H | The standard Hide Others |
| Show All | | The standard Show All |
| — | | |
| Quit Midi Harbor | ⌘Q, or ⌥⌘Q in App Store mode | Quits; in App Store mode stops the daemon first |
**File**
| Item | Shortcut | Does |
|---|---|---|
| New Virtual Port… | ⌘N | Shows Endpoints and opens the new virtual port dialog |
| New Network Port… | ⌥⌘N | Shows Endpoints and opens the new network port dialog |
| New Route… | ⇧⌘N | Shows Routes and opens the new route dialog |
| — | | |
| Export Diagnostic Report | | Shows Settings, where the report says where it was saved |
| — | | |
| Close Window | ⌘W | Ends the window, or closes it to the menu bar in App Store mode |
The New items do nothing while no daemon answers.
**Edit**
| Item | Shortcut |
|---|---|
| Cut | ⌘X |
| Copy | ⌘C |
| Paste | ⌘V |
| Select All | ⌘A |
macOS adds its dictation and emoji items below them.
**View**
Each page in the order the sidebar lists them, on ⌘1 to ⌘6: Endpoints, Routes, Bluetooth,
Activity, Monitor, Settings. macOS adds Enter Full Screen.
**Window**
| Item | Shortcut | Does |
|---|---|---|
| Minimize | ⌘M | The standard Minimize |
| Zoom | | Maximizes the window, or restores it |
| — | | |
| Bring All to Front | | The standard Bring All to Front |
macOS adds its tiling items and the window itself.
**Help**
| Item | Opens |
|---|---|
| Midi Harbor Help | `https://github.com/grmrgecko/midi-harbor/blob/main/docs/README.md` |
| Report an Issue | `https://github.com/grmrgecko/midi-harbor/issues` |
macOS adds its search field.