On this page
- I can't see Moor in the menu bar
- Moor asks to move to Applications every time
- Apple's Dock is showing alongside Moor's
- Apple's Dock is gone and Moor isn't showing a dock
- No badges or minimized windows in Moor's docks
- Window previews don't appear
- The Window Switcher doesn't open
- The Window Switcher stays open, or closes too soon
- Snapping doesn't move a window
- Mast hides nothing
- Mast search says it needs Accessibility
- Moor Bar shows “Allow Accessibility” instead of menus
- Moor Bar isn't showing
- An item in Moor Bar opens nothing
- Desktop widgets don't show
- Hold finds nothing
- There are more open apps than fit
- The Mail peek says it needs permission
- A widget shows “Set Up”
- A revenue widget stays empty after adding its key
- “Activate in Moor” didn't do anything
- I lost my license key
- Something's wrong and I want to tell you
- I want my old Dock back
- I removed something by mistake
- A file in my dock is dimmed
- A Shortcut tile shows an error
- The Mail or Calendar peek is empty
- Something froze or crashed
Troubleshooting
I can't see Moor in the menu bar
On MacBooks with a camera notch, a crowded menu bar hides icons behind the notch. Hold ⌘ and drag the Moor icon toward the clock (from another display if you have one), or remove a few icons you don't need in System Settings → Menu Bar. You can always open Moor again from Spotlight — that opens its Settings.
Moor asks to move to Applications every time
Moor is running from somewhere other than Applications — the disk image, Downloads, the Desktop. Choose Move to Applications, or drag Moor into Applications in Finder and open it from there.
Apple's Dock is showing alongside Moor's
The active profile is set to Apple's Dock or Both. Change it in Settings → Profiles, or with moor://mode?mode=custom. If it switched by itself, check the profile's rules under Switch automatically.
If the profile is set to Moor's docks, Apple's Dock stays when none of its docks can be on screen: the profile has no Custom Dock (none added, or the last one was deleted), or there's no display to put them on. The menu bar menu says which, and choosing that line opens Settings → Docks. Add a dock to the profile and Apple's Dock hides again. Moor never hides Apple's Dock unless one of its own docks is showing.
Apple's Dock is gone and Moor isn't showing a dock
Open Moor again: when it starts, a Dock it left hidden comes back unless one of its docks is on screen. If Moor isn't installed any more, run defaults delete com.apple.dock autohide-delay; defaults delete com.apple.dock autohide-time-modifier; defaults write com.apple.dock autohide -bool false; killall Dock in Terminal.
No badges or minimized windows in Moor's docks
Turn on Accessibility for Moor: Settings → Permissions → Accessibility → Turn On, then allow Moor in System Settings → Privacy & Security → Accessibility. Settings → Setup lists anything still missing.
Window previews don't appear
Check that Settings → Docks → Window previews is on. They need Accessibility for the window list and Screen Recording for the pictures: choose Turn On… there, then allow Moor in System Settings → Privacy & Security → Screen & System Audio Recording. Without Screen Recording you still get a list of window titles. See Window previews.
The Window Switcher doesn't open
It's part of Helm. Turn Helm on in Settings → Parts, then check Settings → Helm → Window Switcher is on. It needs Accessibility. Hold ⌥ and press Tab, or choose another shortcut under Open with. See Helm.
The Window Switcher stays open, or closes too soon
By default it stays open after you type, press an arrow or look for a moment, until you press Return or Esc. To always switch when you let go of ⌥, turn on Close when I let go of ⌥ in Settings → Helm.
Snapping doesn't move a window
Helm needs Accessibility to move windows. Allow Moor in System Settings → Privacy & Security → Accessibility. Dragging to an edge works on the left, right and top edges and the corners, not the bottom, and not on an edge that runs into another display. Moor's own windows aren't snapped by dragging.
Mast hides nothing
Mast needs its divider (⟨) to the left of its icon (‹). Hold ⌘ and drag the divider to the left of the icon. Settings → Mast says if the order is wrong. If you turned Moor off under System Settings → Menu Bar, its items can't appear. See Mast.
Mast search says it needs Accessibility
Allow Moor in System Settings → Privacy & Security → Accessibility, then search again.
Moor Bar shows “Allow Accessibility” instead of menus
The Apple menu, the app's menus, other apps' items and Control Center in Moor Bar need Accessibility. Until Moor has it, the bar shows one Allow Accessibility button in their place. Click it, then Allow… in Settings → Moor Bar, and switch Moor on in System Settings. Moor's menu, the clock, widgets and your text work without it.
Moor Bar isn't showing
Moor Bar steps aside in full-screen apps, while Control Center or Notification Center is open on that display, and when Apple's menu bar is set to hide itself (System Settings → Menu Bar). Apple's own menu bar is there instead. If it's gone everywhere, check that Moor Bar is on in Settings → Parts.
An item in Moor Bar opens nothing
A few apps' menu bar items only answer a real click on Apple's bar. When one opens nothing, Moor shows a small menu saying so, with a way to open the app itself.
Desktop widgets don't show
Check Deck is on in Settings → Parts. Deck's widgets hide while an app is full screen on that display, and in Stage Manager if you set it to hide desktop widgets. Open Settings → Deck and choose Edit on Desktop to bring them forward. See Deck.
Hold finds nothing
Hold uses Spotlight. If Spotlight is off for a folder, Hold can't see it. Hold also leaves out Library, hidden folders and files that are only in iCloud. See Hold.
There are more open apps than fit
They scroll along the dock. Use the mouse wheel or trackpad over the running apps, or the arrows at the ends. See When the dock is full.
The Mail peek says it needs permission
Choose Allow… in the peek; macOS asks once whether Moor may read Mail's inbox.
A widget shows “Set Up”
Click it (or press ⌃⌥E and click it) to finish its settings. For revenue widgets, choose Connect on the widget, or add the key in Settings → Accounts — see Revenue.
A revenue widget stays empty after adding its key
Choose Test next to the key in Settings → Accounts. If Moor can't save a key to your Keychain it says why and keeps what you typed. Shopify needs an Admin API token with read access to orders; Stripe a restricted key with read access to Balance, Charges and Customers.
“Activate in Moor” didn't do anything
Make sure Moor is installed and has been opened once on this Mac, then choose Activate in Moor again. Or copy the key and paste it into Settings → General → License.
I lost my license key
Find it at moorapp.com/license with your email and billing postal code. See Buying.
Something's wrong and I want to tell you
Menu bar → Help → Send Feedback… opens an email to us with your Moor and macOS versions, and a short report of any recent hangs or crashes attached (no personal data — remove it if you like).
I want my old Dock back
Menu bar → Manage Profiles → Restore Original Dock…, or Settings → Sync & Backup → Your Dock. Quitting Moor also shows Apple's Dock again, with the auto-hide you had before Moor.
I removed something by mistake
Press ⌘Z, or choose Put back on the bar that appears. It works for a removed item, a deleted theme and a profile whose settings you replaced. See Undo.
A file in my dock is dimmed
The file has moved or been deleted. Click it, or right-click and choose Locate…, to point to it again.
A Shortcut tile shows an error
Click it to see what went wrong, then choose Retry.
The Mail or Calendar peek is empty
A peek that couldn't read your mail or calendar isn't remembered, so it tries again the next time. Choose Try Again, Open Mail or Allow Calendar in the peek.
Something froze or crashed
Settings → Sync & Backup → Diagnostics shows hangs and crashes from the last week. Copy Report and send it to support@moorapp.com.
This page as Markdown: /docs/troubleshooting.md