SuperTab 7 Documentation

Updated September 2026

SuperTab 7 is a menu bar utility for macOS. Press one shortcut and a panel appears with your apps, windows, clipboard history, files and anything else you put in a row.

This page covers the whole app. Two parts have guides of their own: plugins and widgets.

Getting started

What SuperTab 7 is

SuperTab 7 is a menu bar utility for macOS. It lives in the menu bar and has no Dock icon. Press its hotkey and a panel appears with your apps, windows, recent files, clipboard history, and anything else you have set up in rows.

Minimum system: macOS 14.6.

Install

  1. Download SuperTab 7 from the product page.
  2. Move SuperTab 7.app to your Applications folder.
  3. Open it from Applications.

First launch

The first time you open SuperTab 7, if you have not granted Accessibility yet, a welcome window appears: Welcome to SuperTab 7. If Accessibility is already granted from a previous install, SuperTab skips the welcome window and goes straight to the menu bar.

The window explains what SuperTab does and walks you through the system permissions it needs.

Press Get Started to begin.

The permissions wizard

After the welcome screen the wizard walks you through Accessibility Access, Screen Recording Access, and Recent Items Access.

Accessibility

SuperTab 7 needs Accessibility permission to list windows across all apps and bring the one you pick to the front.

Click Request Access and enable SuperTab 7 in the system dialog. When you grant it, the wizard shows Accessibility Granted and moves on to the next step on its own.

Screen Recording

Screen Recording is used to draw previews of your open windows. Without it, the window list still works — just without thumbnails.

Click Request Access and enable SuperTab 7 in the system dialog.

Recent Items (optional)

This step only appears if macOS keeps SuperTab 7 from reading your recent apps and documents. If SuperTab can already read them, the wizard skips the step on its own.

You can Skip the step. Everything else in SuperTab keeps working; only the Recent Applications and Recent Items rows stay empty until you grant Full Disk Access.

If you press Open Settings, the wizard sends you to System Settings so you can add SuperTab 7 to the Full Disk Access list. When it detects that Recent Items became readable, the step shows Recent Items Available and offers Finish.

After the wizard

When the wizard ends, the welcome window closes and SuperTab 7 sits in the menu bar.

Press ⌥Tab to open the panel.

The menu bar item gives you Show SuperTab, Settings…, and a few other actions — see the Panel article.

If the wizard opens again later

If you ever revoke Accessibility for SuperTab 7 in System Settings, the wizard opens on the next launch — Accessibility is required for the panel to work.

Permissions

SuperTab 7 asks macOS for three permissions. Accessibility is required for the panel to open at all. Screen Recording is optional — the app still runs without it, just without window thumbnails. Full Disk Access is optional and only affects the Recent Items and Recent Applications rows on macOS versions where those lists sit behind it.

Accessibility

What it does. Lets SuperTab 7 list windows across all apps, bring the one you pick to the front, and paste clipboard entries into the app you were using.

If it is off, the menu bar shows ⚠︎ Accessibility is off. Turn it on as described below.

How to grant it.

If it stops working. Open System Settings → Privacy & Security → Accessibility and turn SuperTab 7 back on. If the switch is already on but the panel still stays empty, turn it off and on again — macOS sometimes needs the toggle to refresh the grant.

Screen Recording

What it does. Lets SuperTab 7 draw window preview thumbnails.

Without it. The window row still works — you can pick a window from the list — but tiles show only the app icon, not a thumbnail. The menu bar shows ⚠︎ Screen Recording is off — no window previews.

How to grant it.

If it stops working. Open System Settings → Privacy & Security → Screen Recording and turn SuperTab 7 back on. If macOS asks, quit and reopen SuperTab 7.

Full Disk Access (Recent Items)

What it does. Full Disk Access lets the Recent Applications and Recent Items rows show your recently used apps and documents.

Without it. If macOS keeps these lists closed, the two rows stay empty. Everything else — apps, windows, Dock, clipboard, custom items, folder rows, drop shelves — works normally.

When it is needed. SuperTab 7 checks whether it can read the folder where macOS keeps those lists. If it can, the wizard skips the step. If macOS locks the folder, the step opens and asks for Full Disk Access.

How to grant it. Add SuperTab 7 to the Full Disk Access list in System Settings:

The Permissions tab in Settings

Open the menu bar item and choose Settings…, then click Permissions. You will see one row for each of the three permissions:

Refresh re-reads the current state of all three permissions. Use it after you toggle a permission in System Settings and want the row to catch up.

Hotkey

Default shortcut

The default hotkey is ⌥Tab (Option + Tab).

Press it anywhere in macOS and the panel appears. Press it again while the panel is open and the selection moves to the next tile in the current row, the way it works in the system app switcher.

You can also open the panel from the menu bar item: Show SuperTab. That entry shows the current shortcut next to it.

Changing the shortcut

Open Settings… → General. The Hotkey section holds a recorder next to the label Toggle SuperTab. Click it and press your new key combination. The panel picks up the change immediately.

Any combination the recorder accepts will work; it is the same recorder macOS apps use. A hotkey needs at least one of ⌘, ⌥ or ⌃ — ⇧ alone is not enough. Function keys (F1–F20) can be used on their own.

Releasing the modifier to pick the selection

By default the panel stays open until you press Return, click a tile, press Escape, or click outside the panel. If you would rather it behave like the system switcher — where letting go of ⌥ activates the selection — turn on Releasing the modifier picks the selection in Settings… → General → Launch.

Notes about this setting:

Closing the panel

The panel closes on any of these:

Selecting an item — Return, a click, or releasing the modifier when the option above is on — activates the item and closes the panel.

The panel

When you press the hotkey, SuperTab 7 draws the panel over whatever you were working on. It stays in front until you dismiss it.

Anatomy

The panel is built from three layers:

Along the top-right of the panel there are two round buttons: esc closes the panel; the gear opens Settings.

Along the bottom is a hint strip with the panel’s keyboard shortcuts.

Keyboard

All keys act on the currently selected tile — the one drawn with the light background.

Move between tiles

Move between tabs

Actions on the selected tile

Closing

Mouse and trackpad

Moving the panel

The panel is movable by its background — grab any empty area between the tabs and rows and drag. Buttons, tiles, and menu triggers are excluded from the drag, so you can grab them without accidentally moving the window.

The position sticks: SuperTab remembers where you last left the panel and opens it there next time. To bring the panel back to the centre of the screen, open the menu bar and choose Reset panel position.

Reordering rows

Each row header shows a handle (three horizontal lines) on the right. Grab the handle and drag the row up or down to reorder. The change is saved to your configuration.

You can drag rows directly on the panel while it is open — you do not need to open Settings.

Which screen the panel opens on

Open Settings… → General → Monitor to pick where SuperTab appears when you press the hotkey:

Tabs

A tab is a set of rows. Each tab holds its own collection of apps, windows, clipboard, folders, and whatever else you want to see together. You can have as many as nine tabs.

The last opened tab is remembered between sessions, so the panel opens on the same tab next time.

Creating a tab

The + button in the tab bar creates a new empty tab and switches to it.

If the tab bar is hidden, click the tab name in the panel header and choose New Tab from the menu.

New tabs are created without a name — they show as Tab 1, Tab 2, and so on until you rename them.

The + button greys out once you have nine tabs.

Renaming a tab

Three ways:

Type the new name in the field and confirm. In the tab bar the confirm button is OK; in the hidden-tab menu (panel header → Rename tab…) macOS asks you to confirm with a button labelled Rename.

Empty names fall back to the tab number.

Icons

Each tab gets a default icon; you can change it from the tab’s context menu.

When tab icons show. With Tabs: Left or Right the icon is always visible next to the tab name — the side bar needs the symbol to read as a bar of tabs, not a column of words. With Tabs: Top, icons show only when Settings… → General → Panel → Show tab icons is on. With Tabs: Hidden, the icon shows in the header of the panel next to the tab name.

Deleting a tab

The panel always keeps at least one tab.

If you have more than one:

Deleting a tab also deletes all of its rows, including anything you added to Custom Items or Drop Shelf rows in that tab. Your files stay where they are — only the panel’s links to them are removed.

Tab bar placement

Open Settings… → General → Panel → Tabs and pick where the tab bar lives:

The Show tab icons toggle appears in that section only when the tabs are set to Top — the other placements always show icons.

Rows

Rows are the horizontal strips inside a tab. Each row shows one kind of thing — running apps, windows, clipboard entries, and so on. You can add rows, remove them, reorder them, and change what each one shows.

The first time you open SuperTab 7, the default tab already has four rows: Applications, Windows, Clipboard History, and Dock Items.

Adding a row

Click Add row at the bottom of the panel (below the last row). A menu opens with every row type, each with a line saying what it shows. Pick a type and the row appears.

Types that can only exist once per tab — such as Windows or Clipboard History — are greyed out in that menu when the tab already has one.

The row menu

Every row has a title with a small ⌄ next to it. Click the title to open the row menu.

The menu holds four sections:

Some row types add their own actions to the menu — Choose Folder… for a Folder row, Clear Drop Shelf for a Drop Shelf row.

Reordering a row

Grab the handle (three horizontal lines) on the right side of the row header and drag up or down.

Deleting a row

Click the × on the right of the row header. macOS asks you to confirm before removing the row — Custom Items and Drop Shelf rows lose their contents together with the row itself.

You can also delete a row from its menu — Delete row at the bottom.


Row types

Windows

Windows from every app on your Mac, including apps running on other Spaces. Minimized windows and windows positioned off-screen are included too.

Each tile shows the app icon (or a thumbnail, if Screen Recording is granted) with the window title. Enter or click activates the window and brings it to the front.

Row-specific actions on a window tile:

Applications

Running apps, with those you’ve used most recently since SuperTab 7 started at the top. Apps you have not switched to since SuperTab was launched are ordered by name.

Enter or click activates the app. If it has a hidden window, it becomes the front app.

Row-specific action:

Dock Items

The persistent apps and files in your Dock, in the same order as the Dock — apps first, then the folders and files section.

Click a tile to open the item, just like clicking it in the Dock.

To change the row, change your Dock.

Recent Applications

Apps you opened recently, taken from the macOS Recent Applications list.

If the row is empty, grant Full Disk Access.

Recent Items

Recently used documents, taken from the macOS Recent Documents list.

Enter or click opens the file with its default app. Right-click → Show in Finder reveals the file in Finder.

If the row is empty, grant Full Disk Access.

Clipboard History

Text, images, and file paths copied to the clipboard. Most recent first; pinned entries always float to the top.

Click or press Enter to bring the entry back to the clipboard. If Paste into the active app on select is on in Settings, SuperTab also pastes the entry into whatever app you were using before opening the panel.

Row-specific actions:

More in Clipboard history.

Custom Items

Files, folders, and apps that you dropped into the row or picked from an Open panel. This is the row for things you want to see even when the app is not running and the file is not in “recent”.

Ways to add an item:

Row-specific actions:

You can drag a tile out of Custom Items into Finder or any other app to drop the file there.

Folder

Shows the contents of a folder on disk. A new Folder row starts pointing at your Downloads folder. The row name is the folder’s name.

Click a tile to open the file. Right-click → Show in Finder reveals it in Finder.

Row-specific action:

If macOS blocks access to the folder, the row shows No access to folder. Grant the necessary permission in Settings… → Permissions.

Plugins

Live information from small scripts: CPU and memory, free disk space, the state of your Git projects — anything a script can print. SuperTab uses the same plugin format as xbar and SwiftBar, so ready-made plugins work as they are.

A new Plugins row comes with a few built-in plugins and a tile that opens the menu for adding your own.

Full guide: How plugins work.

Widgets

Small HTML panels drawn inside a row: a calendar, a clock for several cities, bars for CPU and memory. A widget is a folder with widget.html and, if you need them, a stylesheet and a script.

Full guide: How widgets work.

Drop Shelf

A staging area for drag-and-drop. Drag files onto the row from Finder, browsers, or Mail — the row is outlined while you drag something it accepts, and the file can be dropped anywhere in the row. Drag them out into another app when you are ready. Files stay in their original location.

Actions on a shelf tile:

Row-specific action:

Like Custom Items, the Drop Shelf accepts files and images dragged into it, and any tile can be dragged out to a Finder window, Mail message, or any other app that accepts a file drop.

Appearance

Open Settings… → General → Panel to change how the panel looks.

Appearance (theme)

Three options:

The choice applies right away — you do not need to reopen the panel.

Panel size

Three sizes:

The width and the tile scale change together. Each row still has its own tile size on top of this (Small / Medium / Large in the row menu), so you can mix a small-panel layout with large tiles in one particular row.

If the screen is too small to hold the panel at the chosen size, SuperTab shrinks it to fit and leaves a small margin from each edge.

Panel background

Two styles:

The panel picks up the new style right away, even if it is already on screen.

Launch at login

Settings… → General → Launch → Launch at login starts SuperTab 7 automatically when you sign in to your Mac.

Show preview on hover

Settings… → General → Launch has a Show preview on hover toggle.

The hover preview is independent from Space (Quick Look): Space always opens a preview for the selected tile, whatever this setting says. See The panel — Keyboard.

Clipboard history

SuperTab 7 keeps a history of what you copied. Entries appear in the Clipboard History row on the panel (see Rows); the history itself is not shown in Settings — the Settings… → Clipboard tab only holds the size limit and other options.

What gets saved

Three kinds of content are captured:

What is skipped

History limit

Open Settings… → Clipboard → Limit → Maximum entries and pick 10, 25, 50, or 100. The default is 50.

When the history reaches the limit, the oldest unpinned entry is dropped as new ones come in. Pinned entries are never dropped by the limit.

Paste into the active app on select

Settings… → Clipboard → Paste into the active app on select is on by default. With it on, choosing an entry in the panel copies it to the clipboard and pastes it into the app you were using before opening the panel.

Note under the setting: Requires Accessibility access. When off, the entry is only copied to the clipboard.

Excluded apps

Settings… → Clipboard → Excluded apps shows the apps whose copies SuperTab leaves out of the history.

Using entries from the panel

Managing entries

License

Status in the menu bar

The License section of the menu bar item shows:

Trial

The free trial lasts 14 days.

Buying a license

Open the menu bar item, choose Enter License Key…, and press Buy in the window that opens.

Entering a license key

Open the menu bar item, choose Enter License Key…, enter the email address you bought with and your license code, and press Activate.

The menu bar item then shows License: Active and your email.

Managing your license

Choose Manage License… in the License section. The window shows:

Moving the license to another Mac

  1. On the old Mac, open Manage License… and press Deactivate….
  2. On the new Mac, choose Enter License Key… and enter the same email and license code.

Updates

SuperTab 7 checks for updates automatically.

Automatic checks

Automatic checks are on by default. SuperTab periodically checks whether there is a new version and shows an update prompt so you can review the release notes and install it.

You decide when to install: nothing is downloaded until you choose to.

Manual check

To check right now, open the menu bar item and choose Check for Updates….

A dialog opens with the current version and, if a new one is available, the release notes and an Install Update button.

What version am I on?

The menu bar item has About SuperTab near the top. Open it to see the version number.

The About panel is the standard macOS one, so it shows the same version macOS knows about.

Troubleshooting

The panel does not open

Almost always this is Accessibility: SuperTab needs it to open the panel, and without it the menu bar shows ⚠︎ Accessibility is off and Show SuperTab is greyed out.

Fix:

  1. Open the menu bar item and click Open System Settings… under the warning.
  2. In Privacy & Security → Accessibility, make sure SuperTab 7 is turned on.
  3. If it is already on, turn it off and back on.

If the menu bar still says ⚠︎ Accessibility is off even though the switch in System Settings looks on: quit SuperTab 7 (menu bar → Quit SuperTab) and reopen it.

Windows have no thumbnails

This is Screen Recording. Without it, the Windows row shows only app icons.

Fix:

  1. Menu bar → Open System Settings… under the ⚠︎ Screen Recording is off — no window previews warning. (Or open Settings… → Permissions, find Screen Recording, and press Open.)
  2. Turn SuperTab 7 on in Privacy & Security → Screen Recording.
  3. If the warning stays on the menu bar, quit and reopen SuperTab 7.

Windows from other Spaces (desktops) are missing

They should be there — SuperTab lists windows across every Space and every app. If a window really is missing, check Accessibility first (a partial grant is often the cause) and then Screen Recording (some apps are visible only when Screen Recording is on).

Minimized windows and windows positioned off-screen are listed too.

Permissions look granted but the app still doesn’t work

The Refresh button in Settings… → Permissions re-reads the current state of all three permissions. Use it after you change something in System Settings and want the app to catch up without a restart.

If Refresh still shows a red ✗ next to a permission you just granted, quit SuperTab 7 (menu bar → Quit SuperTab) and reopen it.

The panel is off-screen (I unplugged a monitor)

Open the menu bar item and choose Reset panel position to bring the panel back to the centre of the screen SuperTab is set to open on (see Settings… → General → Monitor).

Recent Applications and Recent Items are empty

Grant Full Disk Access in Settings… → Permissions → Full Disk Access (recent items) → Open, then turn SuperTab 7 on in System Settings.

Settings do not stick between restarts

A yellow banner at the top of Settings… explains what is happening. Possible causes:

Reset permissions

If a permission is on in System Settings but SuperTab still asks for it or behaves as if it were off:

  1. Quit SuperTab (menu bar item → Quit).
  2. Open Terminal and run: tccutil reset All com.macplus-software.com.SuperTab-7
  3. Open SuperTab again. It asks for the permissions from the start.

Start over with default tabs and rows

Optional. Your tabs, rows and the items you added to them are removed; everything else stays.

  1. Quit SuperTab.
  2. Open Terminal and run: defaults delete com.macplus-software.com.SuperTab-7 mv ~/Library/"Application Support/SuperTab 7/configuration.json" ~/.Trash/
  3. Open SuperTab. It starts with the default tabs and rows. Your license, plugins, widgets and clipboard history are kept.

If you change your mind, put configuration.json back from the Trash before opening SuperTab.

Getting more help

The Send Feedback… entry in the menu bar opens the contact form.

The Documentation… entry opens this documentation site.

Frequently asked questions

Permissions

How do I grant Accessibility, Screen Recording, or Full Disk Access? See Permissions.

Recent Applications and Recent Items are empty. Grant Full Disk Access in Settings… → Permissions → Full Disk Access (recent items). See Permissions.

Hotkey

What is the default hotkey? ⌥Tab (Option + Tab). See Hotkey.

How do I change the hotkey? Settings… → General → Hotkey → Toggle SuperTab. Click the recorder and press your new key combination. See Hotkey — Changing the shortcut.

Can the panel stay on screen until I pick something? Yes, that is the default. The panel stays open until you press Return or Escape, click a tile, or click outside it. To activate the selection when you release the modifier instead, turn on Releasing the modifier picks the selection in Settings… → General → Launch. See Hotkey.

Panel, tabs, and rows

Can I change the size of the panel? Yes. Choose Small, Medium, or Large in Settings… → General → Panel → Panel size. See Appearance — Panel size.

How do I remove an app from the panel? It depends on the row:

See Rows.

Can I reorder rows? Yes. Drag the three-lines handle in the row header up or down. See Panel — Reordering rows.

Clipboard

What is stored in the clipboard history? Text, images, and files you copy. Apps listed in Settings… → Clipboard → Excluded apps are left out. See Clipboard history.

How do I clear the history? Settings… → Clipboard → Clear history. This deletes every entry, including pinned ones, after you confirm.

License

How do I buy or activate SuperTab 7? Choose Enter License Key… in the menu bar item. Press Buy to purchase, or enter your email and license code and press Activate. See License.

Updates

What’s new in the latest version? The update window shows the release notes for each new version. See Updates.

Something else

The app does not respond as expected. Check that Accessibility and Screen Recording are on for SuperTab 7. See Permissions. If that does not help, choose Send Feedback… in the menu bar item.