TuckBar

Support

Setup help, common questions, and how to reach a human.

Email hello@tuckbar.com and you'll hear back. For bugs or feature requests, you can also open an issue on GitHub.

Setting up permissions

TuckBar needs two macOS permissions to work. macOS will prompt you the first time, and you can manage them later in System Settings.

Screen Recording

This lets TuckBar match the cover to your wallpaper so the menu bar disappears seamlessly instead of turning into a black strip. The capture stays on your Mac and is never stored or sent (see the privacy policy). To enable it: System Settings, then Privacy & Security, then Screen & System Audio Recording, and turn on TuckBar.

Automation

This lets TuckBar hide and show the menu bar and the Dock instantly. To enable it: System Settings, then Privacy & Security, then Automation, then allow TuckBar to control System Events. If you ever declined the prompt, TuckBar shows a banner with a button to open the right settings pane.

Using TuckBar

Tag a display

Open TuckBar from the menu bar and tag the display you want kept clean (usually your OLED). The bar tucks on the tagged display and stays put on the others.

Reveal the bar

Move your pointer to the top edge of a tagged display and the real menu bar slides back. Move away and it tucks again.

Untuck for a while

Need the menu bar for a recording or a menu-heavy app? Use untuck to bring it back for a set time. TuckBar re-tucks itself when the timer is up.

Hide the Dock too

Optionally hide the Dock while a tagged display is connected. It comes back when you unplug.

Troubleshooting

The menu bar still shows on my tagged display

Check that Screen Recording and Automation are both granted (see above), then toggle the display's tag off and on. A relaunch from the menu bar clears most stuck states.

The cover doesn't match my wallpaper

TuckBar refreshes the wallpaper sample periodically. If you just changed wallpapers, give it a moment or re-tag the display.

How do I uninstall?

Quit TuckBar from its menu, which restores your menu bar and Dock, then drag the app to the Trash. Turning off "open at login" first is optional but tidy.

System requirements

  • macOS 14 or later
  • Apple Silicon or Intel

Still stuck?

Email hello@tuckbar.com with your macOS version and a short description of what happened, and we'll help.