On this page

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