Repository navigation
Menu bar
MacroSIP keeps a status item in the menu bar from the first launch. The app keeps working with the main window closed, so the menu bar icon is where you see the registration state, answer the question "did I miss a call?" and dial quickly.
A monochrome handset that follows the menu bar's appearance:
| State | Appearance | When |
|---|---|---|
| Offline | outline handset | No account is registered, or there are no accounts. Tooltip "Offline". |
| Registered | solid handset | At least one account is registered. |
| On call | solid handset with the call timer beside it, "04:12" | A connected call exists. Clicking the icon brings the main window forward. |
| Missed | red count badge on the handset | Unseen missed calls. The timer wins while a call is active; the badge comes back after the call. |
| Do Not Disturb | moon glyph beside the handset | DND is on. |
| No network | outline handset with a slash; tooltip "MacroSIP · No network" | The Mac has no network path. |
The missed-call badge clears when you open the Call Log tab.
Click the icon for a native menu, top to bottom:
| Item | Behaviour |
|---|---|
| Account lines, one per enabled account | Status dot, account name and address. A failed account is red with "Failed: 403 Forbidden". Click opens Settings › Accounts with that account selected. |
| Voicemail: 2 new, one per enabled account with a voicemail number | Envelope glyph, filled while messages wait. Click calls the account's voicemail number through that account. Reads "Voicemail · Office: 2 new" when several accounts have a number; dimmed ("Voicemail: 0 new") while the account's indicator says nothing waits. Needs Voicemail number in the account editor (Accounts); the count comes from the voicemail indicator (MWI), see Incoming calls. |
| Quick dial: "Call number or name…" with a green call button | Type a number or SIP URI and press Return; the call goes through the default outgoing account. Contact suggestions exist only in the main window. |
| Recent Calls | The last five entries with direction icon, name or number and time; missed calls in red. Click calls back through the entry's account. |
| Do Not Disturb ▸ | Checkmark when on. Submenu: Off, On, For 30 minutes, For 1 hour, Until tomorrow 9:00. While a timer runs the title reads "Do Not Disturb · 27 min". DND rejects calls with 486 Busy Here and publishes Do Not Disturb. |
| My Status ▸ "Available ›" | Available, Away, Do Not Disturb. Publishes your presence on every account with Publish my presence on. Choosing Do Not Disturb here also turns DND on; the two stay in sync. |
| Show MacroSIP (⌘0) | Brings up the main window. |
| Settings… (⌘,) | Opens Settings. |
| Quit MacroSIP (⌘Q) | Quits. With a call in progress it asks "End the call and quit?". |
With no accounts the account lines are absent, quick dial is disabled and recent calls are still listed. Accounts without a voicemail number have no Voicemail item.
The main window's status bar has two related items at its right end: an envelope badge with the number of new voicemail messages (a click dials the voicemail number) and a gear button that opens Settings at the last used tab, the same as Settings… here (see Accounts).
| Shortcut | Action |
|---|---|
| ⌥⌘D | Toggle Do Not Disturb (Call menu). |
| ⌘0 | Show MacroSIP. |
| ⌘, | Settings. |
| ⌘Q | Quit. |
| ⌘1 – ⌘9 | Quick keys 1–9 while MacroSIP is frontmost (see Quick keys). |
The Dock icon carries one red count: the unseen missed calls (the same as the menu bar icon and the Call Log tab, clearing when the Call Log tab is opened) plus, when messages are switched on, the unread messages, which fall as you read the conversations (Messages). The menu bar icon counts missed calls only.
Settings › General › Keep running in the menu bar when the window is closed is on by default: closing the main window (⌘W or the red button) leaves MacroSIP registered and reachable; incoming calls still show the floating window and notification (Incoming calls). Turn it off if closing the window should quit the app.
Settings › General › Show icon in the Dock hides or shows the Dock icon. With the Dock icon hidden the menu bar icon and the main window remain, and you reach the window with Show MacroSIP (⌘0) from the menu. The missed-call badge is then visible on the menu bar icon only.
Settings › General › Launch at login starts MacroSIP when you log in, so the menu bar icon and your registrations are there before the first call of the day. There is no prompt about it on first run.
What you choose under My Status is what colleagues who watch your number see as the dot on your contact (see Contacts and call log). A timed Do Not Disturb restores the previous status when it ends.
User guide
- Installation
- Accounts
- Calls
- Incoming calls
- Contacts and call log
- Messages
- Directory
- Quick keys
- Audio
- Settings
- Menu bar
- Troubleshooting
For developers
Русский
中文