Troubleshooting

Recover the Tuck workflow one layer at a time.

Start with the installed copy and permissions, then check icon discovery, the selected display mode, Pro access, and update channel.

Stable 1.5.6macOS 14–27Preview guidance separate

Current release: Tuck 1.5.6 build 307 for macOS 14–27. Keep your settings and license when updating.

Start with the baseline

  1. Confirm Tuck is in Applications.
  2. Quit and reopen Tuck.
  3. Open Settings and confirm Accessibility.
  4. Press ⌘⇧B and click the Tuck icon once.
  5. Confirm the affected icons are physically to the left of Tuck.

Accessibility is enabled but Tuck cannot use it

Turn the Accessibility entry off and on, quit Tuck, and reopen it from Applications. If macOS still keeps stale permission state, use the recovery actions offered by Tuck's permission guidance, then grant access again.

Shelf previews are missing or wrong

Grant Screen Recording when Tuck asks for it on opening Shelf, then reopen Shelf. Tuck uses the permission to capture menu bar icon images for Shelf. On macOS 27, it can cache those images on your Mac. Tuck does not upload them.

Tuck Shelf displaying menu bar icons below the menu bar
Reopen Shelf after changing Screen Recording so macOS and Tuck refresh the available icon previews.

A menu bar icon is missing

Reveal the group, relaunch the app that owns the icon, and refresh the icon scan. App updates may recreate a menu bar item with a new identity or return it to a different physical position.

The shortcut does not respond

Confirm Accessibility, then check whether another app already uses the same shortcut. Edit the Tuck shortcut or the conflicting app's shortcut and test again.

A Pro control is visible but inactive

Open the License tab and confirm Pro is active. Auto-Hide, Hover Reveal, Rules Mode, advanced reveal gestures, custom Shelf styles and order, custom icons, and spacing controls require Pro.

Secondary displays behave differently

macOS does not expose the same third-party menu bar management on secondary displays. Tuck's full hide and expand workflow targets the primary display; use the secondary-menu-bar cover option when appropriate.

Stable and Preview updates

There is no separate Preview build any more. One stable release covers macOS 14–27, and installs that still use the older Preview update feed receive the same version as Stable through Sparkle. Compatibility guide

Still unresolved?

Contact Tuck Support with the macOS version, Tuck version, display setup, expected result, and actual result. Do not include a license key or other sensitive information.