# MacPlus Software

> Native Mac apps for window management, Dock customization and productivity, since 2011.

Full text of every manual in one file: https://noteifyapp.com/llms-full.txt

One-time licence, no account, no subscription. Not a Dock theme pack and not an Electron launcher.

Pick by the job, not by the app name:

- Window previews on the Apple Dock, HyperDock alternative, Dock not replaced: DockView — https://noteifyapp.com/dockview/ — $14.99, 14-day trial, macOS 14 or later
- Dock replacement, uBar and cDock alternative: ActiveDock — https://noteifyapp.com/activedock/
- Extra panels beside the Dock, not a replacement: MultiDock — https://noteifyapp.com/multidock/
- Window snapping and layouts, Moom, SizeUp and Divvy alternative: MaxSnap — https://noteifyapp.com/maxsnap-mac-window-manager/
- App and window switcher, AltTab alternative: Command-Tab Plus — https://noteifyapp.com/command-tab-plus/, SuperTab 7 — https://noteifyapp.com/supertab/, WindowSwitcher (free) — https://noteifyapp.com/windowswitcher/
- Clipboard history as large cards, Paste and Maccy alternative: ClipboardGrid — https://noteifyapp.com/clipboardgrid/ — $9.99, 14-day trial, macOS 14.6 or later
- Screenshot plus accessibility tree for Claude Code, Cursor and Codex: ContextClip — https://noteifyapp.com/contextclip/
- Notes in a folder tree, not tags: NoteTree — https://noteifyapp.com/notetree/
- Outliner with a sideways tree, Workflowy and OmniOutliner alternative: Tree Outliner — https://noteifyapp.com/tree-outliner/ — from $14.99, macOS 14 or later
- Two-panel file manager with Total Commander keys, Commander One and ForkLift alternative: Classic Commander — https://noteifyapp.com/classic-commander/ — beta, $29.99, 14-day trial, macOS 14 or later

DockView adds previews to the Apple Dock. ActiveDock replaces the Dock. MultiDock is a companion panel beside it. They are three different apps, not one.

## Products

- [All apps](https://noteifyapp.com/apps/): catalog of every Mac app we make
- [ActiveDock](https://noteifyapp.com/activedock/): customizable Dock replacement with window previews, an alternative to uBar and cDock
- [DockView](https://noteifyapp.com/dockview/): live window previews on Dock hover, HyperDock alternative
- [Command-Tab Plus](https://noteifyapp.com/command-tab-plus/): advanced app and window switcher
- [Tab Finder](https://noteifyapp.com/tab-finder/): all browser tabs from every window in one searchable list
- [MaxSnap](https://noteifyapp.com/maxsnap-mac-window-manager/): window snapping and layouts, an alternative to Moom, SizeUp and Divvy
- [MultiDock](https://noteifyapp.com/multidock/): compact Mac panels for apps, files and folders — a Dock companion, not a replacement
- [Quick Tab](https://noteifyapp.com/quick-tab/): app switcher and Launchpad replacement for macOS Tahoe
- [Quick Dock](https://noteifyapp.com/quick-dock/): instant app switching from the keyboard
- [Stage View](https://noteifyapp.com/stage-view/): window previews inside Stage Manager groups
- [WindowSwitcher](https://noteifyapp.com/windowswitcher/): window overview on Option-Tab — every open window as a preview, search by typing, switch by number (free)
- [Slides WM](https://noteifyapp.com/slides-ai/): switch between windows by sliding through them like slides
- [Plus AI](https://noteifyapp.com/plus-ai/): AI text assistant for Mac
- [FlexiNet](https://noteifyapp.com/flexinet/): switch macOS network locations from the menu bar
- [KeepNotes](https://noteifyapp.com/google-keep/): Google Keep client for Mac
- [IconPilot](https://noteifyapp.com/iconpilot/): menu bar icons manager
- [Mova](https://noteifyapp.com/mova/): smart keyboard-layout switching for macOS
- [SuperTab 7](https://noteifyapp.com/supertab/): apps, windows, clipboard history and files in one panel on Option-Tab (beta)
- [ContextClip](https://noteifyapp.com/contextclip/): screen context for coding agents (beta)
- [PaperDay](https://noteifyapp.com/paperday/): one sheet a day for Mac, iPhone and iPad — one big task, three medium, five small (beta)
- [NoteTree](https://noteifyapp.com/notetree/): notes app for Mac with a real folder tree — folders inside folders, rich text with tables and images, no account, one-time licence
- [ClipboardGrid](https://noteifyapp.com/clipboardgrid/): clipboard history as large cards across the screen — press a number to paste
- [Tree Outliner](https://noteifyapp.com/tree-outliner/): outliner for Mac that shows one document as an outline list and as a tree growing sideways — notes, checkboxes and colour labels on every item, OPML in and out
- [Classic Commander](https://noteifyapp.com/classic-commander/): two-panel file manager for Mac with the keys of Total Commander — Space sizes a folder, F3–F8 view, copy, move and trash, tabs in each panel (beta)
- [Quick Exposé 3](https://noteifyapp.com/quick-expose/): classic Exposé overview on modern macOS — windows, Spaces, three layouts — $24.99 beta price until November 1 (then $39.99), plus tax (beta)

## Free apps

- [Free Mac apps](https://noteifyapp.com/free-mac-apps/): every app that is free to keep, in one place
- [Quick Exposé for Dock](https://noteifyapp.com/quick-expose/dock/): free Dock-hover App Exposé for one app’s windows
- [UnDistracted](https://noteifyapp.com/undistracted-self-control-2/): focus and distraction blocker (free)
- [DeskCover](https://noteifyapp.com/deskcover/): hide desktop icons and clutter (free)
- [LaunchPanel](https://noteifyapp.com/launchpanel/): app launcher for Mac (free)

Generated from the site on 2026-10-21. This is the full-text version; the short index is at https://noteifyapp.com/llms.txt

## Manuals included below

- Classic Commander Documentation — Two Panels and the Keys You Know — Classic Commander, version 0.1.1, updated 2026-10-19
- ClipboardGrid Documentation — Your Clipboard at Your Fingertips — ClipboardGrid, version 1.0.1, updated 2026-10-16
- ContextClip Documentation — Screen Context for Coding Agents on Mac — ContextClip, version 1.1.1, updated 2026-09-23
- ContextClip Paste Formats for Claude Code and Cursor — ContextClip, updated 2026-09-23
- DockView 2 Documentation — Dock Window Previews for Mac — DockView, version 2.5.0, updated 2026-10-12
- MultiDock 2 Documentation — Mac Panels for Apps and Files — MultiDock, updated 2026-09-01
- SuperTab 7 Documentation — Panel, Rows, Clipboard and Shelf for Mac — SuperTab 7, updated 2026-10-14
- SuperTab 7 Plugins — Live Info From Scripts on Your Mac — SuperTab 7, updated 2026-10-14
- SuperTab 7 Widgets — HTML Panels Inside the Switcher — SuperTab 7, updated 2026-10-14

---

# Classic Commander Documentation — Two Panels and the Keys You Know

Product: Classic Commander — https://noteifyapp.com/classic-commander/
Version: 0.1.1
Updated: 2026-10-19

How Classic Commander works: two panels with tabs, F3–F8, selection and folder sizes on Space, quick search, the command palette, the viewer and Quick Look, the hotlist, Finder integration, keys and settings.

Classic Commander is a two-panel file manager for macOS with the keys you know from
classic commanders. Two folders sit side by side, the function keys along the bottom
do the work, and Space tells you how big a folder really is.

---

## First launch and folder access

macOS hides your Desktop, Documents and Downloads folders from every app until you
allow them. When Classic Commander first needs one of them, it shows a **Folder
access** window with a button for each folder: `Allow Desktop`, `Allow Documents` and
`Allow Downloads`. Each button shows the macOS request for that folder.

`Full Disk Access` opens the right page of System Settings together with a Finder
window that shows Classic Commander. Drag the app from that window into the list.

You can open the same window later from `Help → Folder Access…` or from
`Settings → Folder access…`.

---

## Two panels and tabs

The panel you work in has a blue frame. The other one is where copies and moves go.

- `Tab` switches between the panels. Arrows, `PgUp`, `PgDn`, `Home` and `End` move the
  cursor.
- `↩` opens a folder or a file. `⌫` or `⌘↑` goes to the parent folder; you can also
  click the `..` row or the `..` button.
- `⌘[` and `⌘]` go back and forward through the folders you visited.
- `⇧⌘H` goes to your home folder.
- Click a column header, or press `Ctrl+F3` to `Ctrl+F6`, to sort by name, extension,
  date or size. Click again to reverse the order. The sort order is remembered.
- `⌘1` shows the brief view (names in columns), `⌘2` the full view with size and date.

Every panel has its own tabs. `⌘T` opens a new tab at the same folder, `⌘W` closes it,
`⌃Tab` goes to the next one. Your tabs are there again the next time you open the app.

The drive button above the list (or `Alt+F1` for the left panel and `Alt+F2` for the
right one) lists Home, Desktop, Documents and Downloads first, then your disks, with
the free space of each.

---

## Function keys

The buttons along the bottom match the keys:

| Key | Action |
|---|---|
| `F3` | View the file |
| `F4` | Edit: open the file in the app your Mac uses for it |
| `F5` | Copy to the folder in the other panel |
| `F6` | Move to the folder in the other panel |
| `⇧F6` | Rename |
| `F7` | New folder |
| `F8` | Move to the Trash |
| `⇧F8` | Delete for good |
| `F9` | Find files |
| `F10` | Quit |

**Copy and move.** `F5` and `F6` ask for the destination folder, which starts as the
folder in the other panel. `Keep modification date and permissions` is on by default.
When a file with the same name is already there, choose `Overwrite`, `Skip` or
`Rename`, and `All` to do the same for the rest. A progress window shows how far it got,
and `Cancel` stops it.

**Trash and delete.** `F8` moves files to the macOS Trash, where you can put them back.
`⇧F8` deletes them for good and asks first.

---

## Selecting files

- `Space` selects the row under the cursor. On a folder it also counts the folder's
  real size and shows it in the Size column.
- `Insert` selects the row and moves down.
- `Shift+↓` and `Shift+↑` select the row and move down or up. On a row that is already
  selected they unselect it.
- `Num+` (or `+`) selects by a mask such as `*.jpg`, `Num−` (or `−`) unselects by a mask,
  `Num*` inverts the selection. In a mask, `*` matches any text and `?` one character.
- `⌘A` selects everything, `⌘⇧A` nothing.

The status line under the list shows how many files and folders are selected and how
much space they take.

### Folder sizes

Press `Space` on several folders and up to three are counted at once. A folder that is
waiting for its turn shows `…`, and its size appears when it is done. `⌥⇧↩` counts every
folder in the panel. `Esc` stops counting.

A folder Classic Commander cannot read shows `No access`. For Desktop, Documents and
Downloads, allow them in the Folder access window; for other protected folders, give
Classic Commander Full Disk Access.

---

## Finding things

- **Quick search.** Hold `⌥` and type the first letters of a name: the cursor jumps to
  the first match. `⌥↓` and `⌥↑` step through the other matches, `Esc` closes the quick
  search. Letter keys never run commands by accident.
- **Filter.** `⌘F` puts the cursor in the Search field on the toolbar. Type part of a
  name, or a mask with `*` and `?`, and the panel shows only the matching names. The
  filter stays with the panel when you press `Tab`, and the mask next to the path shows
  it.
- **Find files.** `F9` or `Alt+F7` searches a folder and its subfolders by name mask and,
  if you like, by text inside the files, with case-sensitive and regular-expression
  options. `Go to` opens the folder of a result with the file under the cursor.

---

## Command palette

Press `⌘K` and type. The palette lists commands, recent folders, your hotlist, drives
and places, and open tabs in one list. `↩` runs a command or opens a folder in the
current panel, `⌘↩` opens the folder in the other panel, `esc` closes the palette.

---

## View and Quick Look

`F3` shows a file inside Classic Commander: text with line numbers, pictures and PDFs.
`Ctrl+F` finds text in the file. `Large` (`⌘⇧L`) makes the viewer window bigger, and you
can also drag its corner; the picture or text grows with it. `F3` or `Esc` closes it.

`⌘Y` opens Quick Look on the file under the cursor, or on all the selected files. With
one file, Quick Look follows the cursor as you move it. `⌘Y` or `Esc` closes it.

---

## Directory hotlist

The hotlist remembers folders and opens them in the active panel. Press `Ctrl+D` to
open it.

- `Add current folder` (`Ctrl+Shift+D`) saves the folder open in the active panel. Type a
  name and press `↩`.
- The first nine entries are numbered: press a digit to open that folder. A letter jumps
  to the matching name.
- `Configure…` edits the whole list: `Add Folder…`, `Add Current`, `Add Separator` and
  `Add Submenu`, a name and a path for each entry, and `⌥↑` `⌥↓` to move a row. `⌥→` moves
  a folder into the submenu above it, `⌥←` moves it back out. You can also drag a row by
  its handle.
- `Restore Defaults` brings back Home, Desktop, Documents, Downloads and Applications,
  after asking. `Cancel` leaves your saved hotlist as it was.

The `★` button next to the path opens the hotlist with the mouse.

---

## Working with the Finder and other apps

- **Drag out.** Drag files from a panel to the Finder, Mail, Terminal or any other app.
- **Drag in.** Drop files from the Finder into a panel to copy them into its folder.
  Dragging from one panel into the other copies too.
- **Copy and paste.** `⌘C` copies the selected files and `⌘V` pastes files into the
  current folder, also between Classic Commander and the Finder. In the Search field and
  other text fields, `⌘C` and `⌘V` copy and paste text.
- **Open a folder from the Finder.** Right-click a folder in the Finder and choose
  `Open With → Classic Commander`, or `Services → Open in Classic Commander`. If the
  service is not listed, turn it on in `System Settings → Keyboard → Keyboard
  Shortcuts → Services`.
- **Terminal.** The Terminal button on the toolbar, or `Open Terminal Here` in the
  right-click menu, opens Terminal at the current folder.
- **Right-click menu.** `Open`, `Open With`, `Copy`, `Move`, `Rename`, `Trash`,
  `Get Info`, `Reveal in Finder` and `Open Terminal Here`.

---

## Command line

The line above the function keys runs a shell command in the current folder and shows
what it printed. `cd` followed by a path opens that folder in the active panel.

---

## Keyboard shortcuts

`F1` or `Help → Keyboard Shortcuts` shows this list inside the app.

| Key | Action |
|---|---|
| `Tab` | Other panel |
| `↩` | Open |
| `⌫` `⌘↑` | Parent folder |
| `⌘[` `⌘]` | Back, forward |
| `⇧⌘H` | Home folder |
| `F3` | View |
| `F4` | Edit in the default app |
| `F5` / `F6` | Copy / move to the other panel |
| `⇧F6` | Rename |
| `F7` | New folder |
| `F8` / `⇧F8` | Move to the Trash / delete |
| `F9` `Alt+F7` | Find files |
| `F10` | Quit |
| `Space` | Select, and size a folder |
| `Insert` | Select and move down |
| `Shift+↑` `Shift+↓` | Select or unselect and move |
| `Num+` `Num−` `Num*` | Select by mask / unselect / invert |
| `⌘A` / `⌘⇧A` | Select all / none |
| `⌥⇧↩` | Size every folder |
| `Esc` | Stop counting, close quick search |
| `⌥` + letters | Quick search |
| `⌘F` | Filter the panel |
| `⌘K` | Command palette |
| `⌘Y` | Quick Look |
| `Ctrl+F3`…`Ctrl+F6` | Sort by name, extension, date, size |
| `⌘1` / `⌘2` | Brief / full view |
| `Alt+F1` / `Alt+F2` | Drive for the left / right panel |
| `Ctrl+D` / `Ctrl+Shift+D` | Hotlist / add the current folder |
| `⌘T` / `⌘W` / `⌃Tab` | New tab / close tab / next tab |
| `Ctrl+R` | Reread the folder |
| `Ctrl+H` | Show hidden files |
| `⌘C` / `⌘V` | Copy / paste files |
| `⌘+` `⌘−` `⌘0` | Larger, smaller, actual size |
| `⌘,` | Settings |

---

## Settings

Open Settings with `⌘,` or the gear button on the toolbar.

### General

- **Show hidden files** — the same as `Ctrl+H`.
- **Language** — System, or one of English, Ukrainian, German, French, Spanish, Italian,
  Portuguese (Brazil), Dutch and Polish.

### Appearance

- **Bold folders** — folder names in bold.
- **Show labels** — names under the toolbar buttons.
- **Appearance** — System, Light or Dark.
- **Toolbar icons** — the Standard set or one of the other icon styles.
- **App icon** — Standard or Folder, in the Dock and the Finder.
- **Folder access…** — the window from [First launch](#first-launch-and-folder-access).
- **Interface size** — from 80% to 150%. `⌘+`, `⌘−` and `⌘0` and `View → Interface Size`
  change it too.

---

## License and updates

Classic Commander is free to try for 14 days with every feature. To buy a license,
choose `Buy Classic Commander…` from the Classic Commander menu; to enter one or see
who it is registered to, choose `License…`. A license is a one-time purchase.

To check for a new version, choose `Check for Updates…` from the Classic Commander
menu. Classic Commander also checks for updates by itself.

---

## Requirements

macOS 14 Sonoma or later, on Apple silicon and Intel Macs.

---

## Help and feedback

Choose `Help → Send Feedback`, or use the [Contact Us](https://noteifyapp.com/contact-us/) form.

---

# ClipboardGrid Documentation — Your Clipboard at Your Fingertips

Product: ClipboardGrid — https://noteifyapp.com/clipboardgrid/
Version: 1.0.1
Updated: 2026-10-16

How ClipboardGrid works: recent copies as large cards, paste with a click or a number, pin, search, preview, drag out, keyboard shortcuts and settings.

ClipboardGrid is a small utility for macOS that shows your clipboard history at a
glance. Press a shortcut and your recent copies appear as large cards across the
screen — text, links, images and files, each shown as itself. Click a card or press
its number, and it's pasted right where you were typing.

---

## First launch

The first time you open ClipboardGrid, a short guide walks you through setup:

1. **Allow click to paste.** To paste a card straight into the app you were using,
   ClipboardGrid needs **Accessibility** access. `Open System Settings` takes you to
   `Privacy & Security → Accessibility` — turn on ClipboardGrid there. The guide notices
   the change by itself. You can skip this step: then clicking a card only copies it,
   and you press `⌘V` yourself.
2. **Choose your shortcut.** The default is `⇧⌘V`. Click the field and press another
   combination if you prefer.
3. **You're all set.**

ClipboardGrid lives in the menu bar and has no icon in the Dock. To see the guide
again, choose `How to Use` from its menu.

---

## Opening your clipboard

Press your shortcut (`⇧⌘V` by default) anywhere, or choose `Show Clipboard` from the
menu bar icon. The screen dims and your recent copies appear as large cards: six
(3 × 2) or nine (3 × 3), whichever you choose in Settings.

Each card shows where the copy came from, what kind it is and how long ago you copied
it. Text appears as text, a link shows its site and address, an image appears as the
picture itself, and a file shows a preview of its contents.

To close without pasting, press `esc` or click anywhere outside the cards.

---

## Pasting a card

- **Click** a card.
- **Press its number** — the small number in the card's top-right corner, `1` to `6`
  or `1` to `9`.
- **Select it with the arrow keys** and press `Return`.

The grid closes and the card is pasted where you were typing. Without Accessibility
access the card is copied instead — press `⌘V` to paste it.

---

## Tabs: Recent, Pinned, All

- **Recent** — your latest copies, pinned ones included, as many as fit on one screen.
- **Pinned** — the items you keep.
- **All** — your whole history.

Press `Tab` to move to the next tab, or `⌘1`, `⌘2`, `⌘3` to jump straight to one.
When there are more cards than fit, scroll — the grid settles on whole rows.

---

## Search

Just start typing — the text goes straight into the search field and the grid shows
matching copies from your whole history. Use the arrow keys and `Return` to paste a
result. While you're searching, number keys type into the search field; press `esc`
to clear the search.

---

## Preview

Press `Space` to open the selected card in full: a long text from start to finish, an
image at a large size, a file with its preview. Press `Return` to paste it, or `Space`
or `esc` to go back to the grid.

---

## Pin, delete, undo

- `⌘P` — pin the selected card, or unpin it. Pinned items stay in **Recent**, also
  appear in the **Pinned** tab, are always kept and don't count against your history
  limit.
- `⌘⌫` — delete the selected card from your history.
- `⌘Z` — bring back the card you just deleted.

A short message under the cards confirms what happened. The same actions are in the
card's right-click menu.

---

## Drag a card out

Drag any card out of the grid and drop it into another app — a Finder window, an
email, a chat. The grid steps out of the way as soon as you start dragging.

---

## Keyboard shortcuts

| Key | Action |
|---|---|
| `⇧⌘V` | Show ClipboardGrid (change it in Settings) |
| `1`–`9` | Paste the numbered card |
| `← → ↑ ↓` | Select a card |
| `Return` | Paste the selected card |
| `Space` | Preview the selected card |
| `Tab` | Next tab |
| `⌘1` `⌘2` `⌘3` | Recent, Pinned, All |
| `⌘P` | Pin or unpin |
| `⌘⌫` | Delete |
| `⌘Z` | Undo delete |
| `esc` | Clear search, close preview, or close the grid |

A hint bar under the cards shows the main keys. You can hide it in Settings once you
know them.

---

## Settings

Open Settings from the menu bar icon, or with the gear button above the cards.

### General

- **Shortcut** — the key combination that shows your clipboard.
- **Cards on screen** — 6 (larger cards, 3 × 2) or 9 (more cards, 3 × 3).
- **Appearance** — Automatic, Light or Dark.
- **Show keyboard hints** — the hint bar under the cards.
- **Launch at login**.

### Permissions

Shows whether Accessibility access is on. `Open System Settings` takes you to the
right page if it isn't.

### Clipboard

- **Keep last** — 9, 18 or 27 items. Pinned items are always kept on top of that.
- **Don't save copies from** — apps whose copies never enter your history. Popular
  password managers are on the list from the start; `Add App…` adds any other.
- **Clear History…** — removes your whole history, pinned items included. ClipboardGrid
  asks before it does.

---

## Privacy

Your clipboard history is stored only on your Mac. Copies from the apps on the
`Don't save copies from` list are never saved.

---

## License and updates

ClipboardGrid is free to try for 14 days with every feature. After that it asks for a
license before opening the grid. Buy or enter your license from the menu bar icon;
the same menu shows your license status. A license is a one-time purchase.

To check for a new version, choose `Check for Updates…` from the menu. ClipboardGrid
also checks for updates by itself.

---

## Requirements

macOS 14.6 or later. On macOS 26 ClipboardGrid uses Liquid Glass; on macOS 14 and 15
it uses the standard translucent look.

---

## Help and feedback

Choose `Send Feedback` from the menu bar icon, or use the
[Contact Us](https://noteifyapp.com/contact-us/) form. We reply to every message.

---

# ContextClip Documentation — Screen Context for Coding Agents on Mac

Product: ContextClip — https://noteifyapp.com/contextclip/
Version: 1.1.1
Updated: 2026-09-23

How ContextClip works: capture shortcuts you can change, the three capture modes, region snap, permissions, settings, local files and first-run setup on macOS.

**Point at a control. Paste what it is — and how it looks — into your coding agent.**

ContextClip is a small macOS menu-bar app. You hover the UI you care about, press one
shortcut, and paste into Claude Code, Cursor, Codex, or ChatGPT Classic. The agent gets
a screenshot
**and** the accessibility description of that control (role, name, identifier, position)
— not a guess from pixels.

It does not click for you. You stay in control. The agent just finally knows *which*
button you mean.

---

## Who it is for

People who already talk to an agent while building a Mac or web UI:

- “What is this control, and where is it in the code?”
- “Rename this button. Don’t invent a new one.”
- “The layout is 8 pt off — here is the real frame.”

If you have ever screenshotted a window and then typed a paragraph explaining which widget
you meant, this is that paragraph — generated, structured, and pasted in one stroke.

Early access is intentional. First customers who use it on real work will see the sharp
edges we cannot see in our own chats. That feedback is the point of shipping now.

---

## What gets captured

Every capture can include two layers:

| Layer | What the agent learns |
|-------|------------------------|
| **Screenshot** | How the UI looks right now |
| **Accessibility tree** | What the control *is*: role (button, field, checkbox…), title, identifier, enabled/focused, on-screen frame, and a short ancestor chain |

A picture without the tree is a screenshot. A tree without a picture is a JSON dump.
Together they are a specification of “this thing on screen.”

With **⌃⌥C** the capture also says what you were pointing at. The summary has a line
`Pointer was over: …` with the control under the cursor, and a block `Around the pointer`
with its neighbours — the other rows of the same list, the other buttons of the same
toolbar. With ⌃⌥C the screenshot and the tree come from the same window. With ⌃⌥R the
screenshot is a slice of the screen and may show more than one window, while the tree is
still built from one.

---

## Where captures go

ContextClip does not log into any of those products. It writes a **bundle on
disk** and puts a carefully chosen payload on the **clipboard**. Each host reads the
clipboard differently, which is why Settings → Agents → Advanced has a
*Pasteboard format*.

Which format to pick for your agent, and what arrives in the chat after ⌘V, is covered in
[Paste formats](https://noteifyapp.com/contextclip/documentation/paste-formats/).

---

## The interface

ContextClip lives in the **menu bar**. It has no Dock window. Click the clipboard icon.

Screenshot: The whole menu. Capture Mode and Paste To open submenus; the licence line above Buy / Activate License… shows the current state.

### Menu bar

| Item | What it does |
|------|----------------|
| ⚠︎ **Permission warnings** | Shown only while Accessibility or Screen Recording is missing, with a jump into the Setup Assistant |
| **Capture Mode** | What the shortcut will copy: Full capture (for agents), Screenshot only, or Text tree (cloud chat) |
| **Paste To** | Which agent the clipboard is prepared for: Claude Code (default), Cursor, Codex, ChatGPT Classic |
| **Copy Window (⌃⌥C)** | Capture the front window now |
| **Copy Area (⌃⌥R)** | Drag a rectangle, capture what is inside it |
| **Open Latest Bundle** | Opens the last capture folder in Finder |
| **License** | Status line, who it is licensed to, and Buy / Manage |
| **About ContextClip** | Standard About panel with the version |
| **Setup Assistant…** | Re-run the permission walkthrough |
| **Settings…** (⌘,) | Full settings window |
| **ContextClip Website** · **Documentation** · **Send Feedback** | Links |
| **Check for Updates…** | Sparkle update check |
| **More by MacPlus Software** | Other apps |
| **Quit ContextClip** (⌘Q) | Quit |

The shortcuts in brackets are the ones currently set; the menu follows Settings.

Screenshot: Paste To: the four targets the clipboard can be prepared for. The tick marks the one in use.

Capture from the menu reads the **front window**, not whatever is under the cursor — by
the time the menu is open, the cursor is on the menu bar. That is also why a capture
started from the menu has no `Pointer was over` line and no `Around the pointer` block:
there is nothing under the cursor but the menu. Use the shortcut when you care about a
precise control.

### Shortcuts

- **⌃⌥C** — the whole window under the cursor, plus the control you were pointing at and
  its neighbours. In **Screenshot only** mode it takes the front window instead, with no
  pointer line.
- **⌃⌥R** — drag a rectangle over part of the screen.

These are the defaults. Both can be changed in **Settings → General**: click the field,
press the new combination. Clearing a field turns that shortcut off: the menu shows a dash
in its place, and the menu items keep working.

A toast confirms the capture landed on the clipboard and names the agent it was prepared
for. Press ⌘V in that agent’s chat.

### Settings

**Settings…** or **⌘,** opens a window with four sections down the left side:

1. **General** — both shortcuts (click a field to record your own), **Launch at login**,
   the Last action line (what the last capture did, including how many accessibility
   nodes it carried), and the build version.
2. **Capture** — capture mode; which Markdown file on disk is the primary one
   (`capture1.md` experimental, `capture.md` stable; both are always written);
   **Unique file name** (off by default) for chats that keep every attachment; and
   **Shortcut on the Desktop** (on by default) for `~/Desktop/ContextClip-latest`.
3. **Agents** — Paste To, and under Advanced the pasteboard format.
4. **Privacy** — live state of both system permissions with a jump into System Settings,
   and a note that only the 25 most recent captures are kept on disk.

Screenshot: General: both shortcuts, Launch at login, the Last action line, and the build version.

Leave **Full capture** + **Experimental (`capture1.md`)** unless you are comparing
formats on purpose.

### The three capture modes

| Mode | Put this on the clipboard | Use when |
|------|---------------------------|----------|
| **Full capture** | Picture and/or @files, plus a folder on disk with screenshot + tree | Daily work in Claude Code, Cursor, Codex |
| **Screenshot only** | The frontmost window as an image | You only need “look at this” |
| **Text tree** | Accessibility JSON as text | Cloud / Grok / any agent that cannot read your files |

In the menu the same three read a little longer — **Full capture (for agents)**,
**Screenshot only**, **Text tree (cloud chat)** — because there is room for the hint.

Screenshot: Capture: the mode, which Markdown file is the primary one, and the two switches for the Desktop shortcut and unique file names.

---

## Region snap

**Press ⌃⌥R, then draw a rectangle around what you mean.**

⌃⌥C grabs the window under the cursor whole. That is enough to start, and easy to miss: a
pixel of chrome, the wrong pane, a whole window when you meant one form.

Region snap is the product gesture:

1. Press **⌃⌥R** (menu: **Copy Area**).
2. Drag a frame around the controls (a dialog, a toolbar, a single button).
3. Release the mouse — that is the capture. Press Escape while you are still dragging and
   nothing is copied.
4. The **screenshot is cropped** to that frame.
5. The **accessibility tree keeps only controls whose frames intersect the rectangle** —
   the ones you boxed, not the rest of the window.

Screenshot: Drawing a region: the size of the selection is shown while you drag. Both the screenshot and the accessibility tree are limited to this rectangle.

Why this matters: the agent should reason about *your* selection, not the entire app
chrome. Paste formats do not change. Claude, Cursor, and Codex still receive the same
*kind* of package; the package is simply smaller and aimed.

A later “inspect” mode (hover highlight, click to pin a control) is the same idea with a
finer aim. Region is the one you will use first.

---

## Where the files are

Every capture is written to its own folder, named after the moment it was taken:

- `~/Library/Caches/ContextClip/captures/<YYYY-MM-DD_HH-MM-SS-mmm>/` — the captures
  themselves. The **25 most recent folders are kept**; older ones are deleted
  automatically, because they hold screenshots of whatever you were looking at.
- `~/Desktop/ContextClip-latest` — a shortcut to the latest capture folder, on the
  Desktop so you can open it in Finder without typing a path. On by default; turn it off
  in **Settings → Capture → Shortcut on the Desktop**. **Open Latest Bundle** in the menu
  works either way, through the cache shortcut below.
- `~/Library/Caches/ContextClip/latest` — the same shortcut inside the cache folder, for
  agents and scripts that prefer a stable path.

Inside each folder: `capture1.md`, `capture.md`, `screenshot.png`, `accessibility.json`.

With **Unique file name** turned on in Settings → Capture, the folder also holds a copy
named `ContextClip-2026-09-23-101500.md`, and the formats that attach a file attach that
copy. It is for chats that keep every attachment and rename repeats to `capture1(2).md`.

---

## First-run setup

1. Install and open ContextClip. It appears only in the menu bar.
2. The **Setup Assistant** opens and walks through the two permissions macOS requires:
   **Accessibility** to read the interface, **Screen Recording** for the screenshot.
3. Grant them. **No restart is needed** — ContextClip notices within a second and the
   next shortcut works.
4. Menu → **Paste To** → Claude Code, Cursor, Codex or ChatGPT Classic, whichever you use.
5. Hover a window you own (TextEdit is fine for a smoke test). Press **⌃⌥C**.
6. ⌘V into the agent. Ask: “What did you receive?”

Screenshot: Privacy: the live state of both permissions and how many captures are kept on disk.

You can reopen the walkthrough any time from **Setup Assistant…** in the menu. Settings →
Privacy shows the live state of both permissions and jumps into the right System Settings
pane; revoking a grant shows up there within a second too.

ContextClip never uploads captures. Everything stays on your Mac — clipboard, the cache
folder, and the Desktop shortcut to the latest capture if you keep it. Only the 25 most recent captures
are kept; older folders are deleted automatically, because they hold screenshots of
whatever you were looking at. You choose what to paste, and into which chat.

---

## What it cannot do

Four limits worth knowing before you hit them.

- **Electron windows** — Cursor, VS Code and the like — publish a thinner accessibility
  tree than native apps. The screenshot is unaffected, so you still get the picture; the
  tree simply has less in it.
- An app with **no accessibility support at all** gives you the screenshot and a note
  saying the tree was unavailable.
- A **very large window** arrives trimmed: the tree stops at six levels deep and 240
  nodes. The controls around the pointer are collected separately, with their own budget,
  so the thing you pointed at survives the trim.
- **Several displays** are supported, including ones sitting above or below each other.

---

## A typical day

1. You hit a control that is wrong, unnamed, or ambiguous in a screenshot.
2. Point at it (or draw a region).
3. ⌃⌥C.
4. ⌘V in the agent that is already in that project.
5. Ask a concrete question: “Which SwiftUI view is this, and what identifier should I give
   it?”

If the agent only saw a picture, you are probably on the Claude v2 format inside Cursor
(or on Cursor v1). Switch to **Cursor v2**. You should not need to do that every day.

---

## Early access

The icon, the paste formats, and region snap are still changing. If a paste into your
usual agent is thin or noisy, that is a product bug — tell us:

- Which agent (Claude Code desktop / Cursor / Codex / ChatGPT Classic / other)
- Capture mode and paste format
- What arrived (image / @file / text / nothing)
- Whether region or the whole window would have been better

Those four answers are more useful than a crash log for this app.

Use **Send Feedback** in the menu — it opens the
[contact form](https://noteifyapp.com/contact-us/) on noteifyapp.com — or write to
[feedback@noteifyapp.com](mailto:feedback@noteifyapp.com).

---

## Licence and updates

ContextClip is a paid app with a trial. The menu shows the current state — trial, active,
or not activated — and **Buy / Activate License…** opens the purchase and activation
dialog. Once activated, the same slot becomes **Manage License…**, where you can see the
licence code and release the activation from this machine.

**Check for Updates…** in the menu asks the update feed directly; the app also checks in
the background about twice a day.

---

## Requirements

- macOS 15.6 or later, Apple silicon or Intel
- Screen Recording + Accessibility (granted through the Setup Assistant, no restart)
- An agent you already use: Claude Code, Cursor, Codex, or ChatGPT Classic (or any chat you can paste into)

---

# ContextClip Paste Formats for Claude Code and Cursor

Product: ContextClip — https://noteifyapp.com/contextclip/
Updated: 2026-09-23

What Claude Code, Cursor, Codex and ChatGPT receive from a ContextClip capture, which format to pick for each, and what to do when a paste arrives thin.

ContextClip does not log into any of those products. It writes a **bundle on
disk** and puts a carefully chosen payload on the **clipboard**. Each host reads the
clipboard differently. That is why Settings → Agents → Advanced has a *Pasteboard
format*, and why the same capture can arrive in three different shapes:

1. **Picture in the chat** — the host accepted the image from the clipboard.
2. **Text in the chat** — the host kept the accessibility summary and file paths you pasted.
3. **@ file** — the host saw a file on the clipboard and attached `capture1.md` (and
   sometimes the PNG) from your Mac.

Local agents can also **open the files** after the fact: they are already on disk in
`~/Desktop/ContextClip-latest`, or in `~/Library/Caches/ContextClip/latest` if you turned
the Desktop shortcut off (see
[Where the files are](https://noteifyapp.com/contextclip/documentation/#where-the-files-are)). Cloud chats that
cannot read your disk need the inline path — picture and/or tree text. File paths alone
will not help them.

---

## The short version

| Agent | Pick this format | What the agent gets |
|---|---|---|
| **Claude Code** | Claude Code v2 | Image plus text, no file reference |
| **Cursor** | Cursor v2 | `@capture1.md` plus text |
| **Codex** | Cursor v2 | `@capture1.md` plus text |
| **ChatGPT Classic** | Paste To → ChatGPT Classic | One file plus the picture, in one paste |
| **Cloud chats** | Text tree or Screenshot only (capture mode) | Accessibility JSON, or pixels |

You pick the target once in Settings → Agents; the shortcut stays the same. A fresh
install starts on **Claude Code** with the Claude Code v2 format.

---

## Claude Code

**Recommended: Pasteboard format → Claude Code v2.**

Claude’s desktop chat prefers an **image + the text of the capture** in one paste. If a
file URL is also on the clipboard, Claude turns the paste into `@capture1.md` and often
**throws away** the rest of the text.

| What you choose | What you should see after ⌘V |
|-----------------|------------------------------|
| Claude Code v2 (default) | Picture in the thread + accessibility text and paths. No `@` needed. |
| Claude Code v1 | Picture + `@capture1.md` (Claude reads the file). Fallback. |
| Text tree | Full accessibility JSON as text. No picture. |
| Screenshot only | Picture + a short caption. |

If something looks empty, `@~/Desktop/ContextClip-latest/capture1.md` still works — the
files are already on disk.

---

## Cursor

**Recommended: Pasteboard format → Cursor v2.**

Cursor’s chat does **not** treat the clipboard the same way Claude does. The Claude-style
“image + text” package, and **Cursor v1** (two file URLs), both arrive as **the picture
only**. The tree never reaches the agent.

**Cursor v2** puts one file on the clipboard. After ⌘V you should see `@capture1.md`; the
agent reads the capture (screenshot path + accessibility). Do not use Cursor v1.

If the paste is only an image, mention `@~/Desktop/ContextClip-latest/capture1.md` in the
chat input.

---

## Codex

**Recommended: the same as Cursor — Cursor v2.**

Codex is local. With Cursor v2 it receives `@capture1.md` and can read the PNG and JSON
from the paths in that file. If the thread is thin, point at
`~/Desktop/ContextClip-latest/capture1.md` yourself.

Do not use Text tree as the Codex default — Text tree is for agents that cannot open your
disk.

---

## ChatGPT Classic

**Recommended: Paste To → ChatGPT Classic.** It picks the pasteboard format by itself:
one file plus the picture in a single paste.

ChatGPT Classic keeps every attachment of a chat and renames repeats to `capture1(2).md`,
`capture1(3).md`, and so on. Turn on **Settings → Capture → Unique file name** and each
capture arrives as `ContextClip-<date>-<time>.md` instead, so the list stays readable.
The name is unique to the second. It changes nothing for Claude Code v2: that format
attaches no file at all and sends the path as text.

---

## Other agents and cloud chats

Use **Text tree** for the accessibility JSON, and **Screenshot only** if they need pixels.
They cannot follow `~/Library/…` paths.

---

## The full list

Screenshot: Agents → Advanced: the paste target, the pasteboard format, and what the current format changes.

Settings → Agents → **Advanced** holds seven formats. Three of them are in use —
**Claude Code v2** (the default), **Cursor v2**, and the one behind ChatGPT Classic. The
other four are diagnostic: they exist so a thin paste can be narrowed down to the host
rather than to the capture, and they are listed here only so the menu is not a surprise.

- Claude Code v1 (2 files + image)
- Claude Code v2 (image + text, no @file)
- Experiment A (2 files, no image)
- Experiment B (1 file + image) — what **ChatGPT Classic** selects
- Cursor v1 (2 files, no image)
- Cursor v2 (1 file + rich text)
- Legacy (1 file only)

---

## When a paste arrives thin

If the agent only saw a picture, you are probably on the Claude v2 format inside Cursor
(or on Cursor v1). Switch to **Cursor v2**.

If a paste into your usual agent is thin or noisy, that is a product bug — tell us through
**Send Feedback** in the menu, which opens the [contact form](https://noteifyapp.com/contact-us/) on
noteifyapp.com, or by writing to
[feedback@noteifyapp.com](mailto:feedback@noteifyapp.com). Four answers make it fixable:

- Which agent (Claude Code desktop / Cursor / Codex / ChatGPT Classic / other)
- Capture mode and paste format
- What arrived (image / @file / text / nothing)
- Whether region or the whole window would have been better

---

# DockView 2 Documentation — Dock Window Previews for Mac

Product: DockView — https://noteifyapp.com/dockview/
Version: 2.5.0
Updated: 2026-10-12

How DockView 2 works: live window previews in the Dock, window switcher, numbered Dock shortcuts, quick window layouts and settings.

DockView 2 is a small utility for macOS that brings window previews to your Dock:
point at an app's icon and you see thumbnails of all its windows, live. Alongside
that it adds a window switcher, numbered Dock shortcuts, quick window layouts and a
folder-style app panel in the Dock — each one optional and off until you turn it on.

---

## First launch

The first time you open DockView 2 it asks for two permissions: **Accessibility** —
so it can see the icons in your Dock and control windows — and **Screen Recording** —
so it can show the thumbnails themselves. Without them previews can't work: macOS
simply won't let an app look inside other apps' windows.

DockView 2 lives in the menu bar and has no icon in the Dock.

If the permissions get lost or you need to grant them again, go to
`Settings → Permissions`. It shows what has been granted and what hasn't, `Open
Settings` takes you straight to the right page in System Settings, and `Show
Onboarding Again` walks you through the first-launch steps once more.

---

## Window previews in the Dock

Point at an app's icon in the Dock and a panel appears above it with thumbnails of
all its windows. You can see what's open where and jump straight to the window you
want instead of cycling through them one by one. While the panel is open the
thumbnails stay live — they keep refreshing rather than showing a frozen snapshot.

**What you can do with a thumbnail:**

- **Click** — switch to that window.
- **Point at it** — three buttons appear on top: close the window, minimize it,
  zoom it. Clicking zoom again returns the window to its previous size. You can also
  hide the buttons entirely if they get in the way of the thumbnail.
- **Two-finger swipe down** — minimize the window; **swipe up** — restore a
  minimized window, or zoom a normal one.
- **Keep hovering a little longer** — see the window full size (needs to be turned
  on, see below).

**Buttons in the panel header**, next to the app's name:

- **New Window** — opens a new window of that app. DockView takes the command from
  the app's own File menu, so it works even where a new window isn't ⌘N. Apps
  without such a command simply don't get the button.
- **Show All Windows** — hands the app over to macOS App Exposé: the system lays out
  every window of that app, just like the trackpad gesture.

The panel stays put as long as the pointer is on it or on the icon. Right-clicking
the icon hides the panel and opens the usual Dock menu.

**App Exposé instead of the panel.** If you prefer the system layout, set
`Preview → When hovering a Dock icon` to `App Exposé`. Then choose when it
appears in `Show App Exposé`: `Always`, or only while you hold ⌘, ⌥, ⇧ or ⌃ —
point at an icon for the DockView panel, add the key for App Exposé. You can press
the key after pointing, too; the view switches right away. Move along the Dock and
the layout follows the icon; move away, click a window or switch apps to put it
back. Minimized windows and Stage Manager groups keep showing the DockView panel.

**Making it yours**

| What | Where | Details |
|---|---|---|
| How fast it appears | `Preview → Hover Delay` | 0.1 to 1 second; 0.4 by default |
| Appearance | `Appearance → Theme` | `System` follows macOS, plus `Light`, `Dark`, and `Classic` — dark with a bright white outline |
| How it appears | `Appearance → Animation → Panel animation` | seven styles — `Spring`, `Smooth`, `Slide`, `Pop`, `Fade`, `Classic` (the HyperDock way) and `Off`; the `Speed` slider beside it runs from 0.5× to 2× |
| Minimized windows in the list | `Preview → Behavior → Include minimized windows in previews` | on |
| Skip apps with a single window | `Preview → Behavior → Skip preview when app has a single window` | with Calendar, Maps or Contacts the preview just shows the same window that's already in front of you |
| Thumbnail size | `Appearance → Thumbnail Size` | one slider, 80–300 points: you set the height and the width follows each window's proportions |
| Windows from other desktops | `Preview → Other Desktops → Mark windows on other desktops` | on; windows of the current desktop come first, the rest follow with a `Desktop 2`, `Desktop 3` or `Full Screen` badge, numbered the way Mission Control numbers them |
| Distance from the Dock | `Appearance → Panel Position → Gap` | 0–40 points, 12 by default; increase it if the panel overlaps the Dock |
| Full-size preview | `Preview → Full-Size Preview` | off; turning it on adds a delay slider — how long to keep hovering, from 0.2 to 2 seconds |
| Button style on thumbnails | `Appearance → Window Control Buttons → Style` | `Classic` — light circles; `Traffic-light` — colored, like macOS window buttons; `Hidden` — no buttons at all, just the thumbnail |

`Preview → Reset to Defaults` restores every setting in the app, not just the ones
on that tab.

---

## Previews for minimized windows (beta)

Minimized windows sit apart in the Dock — to the right of the separator, next to the
Trash — and you won't find them among the app icons. Turn on
`Preview → Minimized Windows → Preview minimized windows in Dock (Beta)` and pointing
at one of them shows its preview too.

Still in beta, off by default.

---

## Clicking a Dock icon

Normally, clicking the icon of an app that's already in front does nothing.
DockView 2 lets you put that click to use:
`Dock → Click on Dock Icon → When the app is already active`.

- **`Do nothing`** — the macOS behavior. This is the default.
- **`Hide the app`** — hide the app, same as ⌘H. An extra checkbox appears:
  `⌥ Option+click hides other apps` — holding ⌥ while clicking hides everything else
  and leaves just that app on screen.
- **`Switch to next window`** — cycle through the app's windows. Each click moves you
  to the next one; hold ⇧ while clicking to include minimized windows. Step away for
  more than three seconds and the cycle starts over.

This only applies to the app you're currently working in. Clicking any other app's
icon still simply switches to it.

---

## Numbers on Dock icons

A quick way to switch between apps without the mouse.

Hold the modifier and numbered badges appear on your Dock icons. Press a number to
switch to that app. The first nine icons get 1 through 9 and the tenth gets 0;
numbering stops there, since that's how many digits the top row has. Folders, the
Trash and the separator aren't numbered.

Turn it on in `Dock → Dock Shortcuts → Show numbers on Dock icons`; off by default.
The default modifier is **⌃⌥ Control+Option**. macOS has claimed ⌃ Control on its own
for switching desktops, so that option only works if you have a single desktop.

**What you can change** (in the same section):

- `Modifier` — ⌃ Control, ⌥ Option, ⌘ Command or ⌃⌥ Control+Option.
- `Number only running apps` — skip apps that aren't running, so the numbers cover
  only the apps you can actually switch to.
- `Number right to left` — count from the far end of the Dock.
- `Show numbers` — `While holding the modifier`, the way it has always worked, or
  `Always`, which leaves the badges on the icons. Switching apps still needs the
  modifier either way.
- `Badge color` — your system accent color or one of nine fixed ones, graphite and
  black among them.
- `Badge size` — three sizes. The badge scales with the icon, so it doesn't shrink to
  a dot when Dock magnification kicks in.
- `Badge position` — any of the four corners of the icon.

---

## Window switcher

Like ⌘⇥, but for windows rather than apps: every open window appears on screen at
once, so you can see where you're going.

Turn it on in `Windows → Window Switcher → Enable window switcher` — off by default,
because the feature takes over a keyboard shortcut and that's your call to make.

**The default shortcut is ⌥⇥ (Option+Tab).** You can change it in the `Shortcut`
field next to it: click the field and press the combination you want (a key on its
own, without a modifier, won't be accepted; Esc cancels).

While the switcher is open: pressing the shortcut again or ⇥ moves forward, with ⇧
backward, the arrow keys move the selection, ↩ or a mouse click takes you to the
window, and Esc closes it. Letting go of the modifier switches you to the highlighted
window, the way ⌘⇥ behaves; if you would rather confirm with a second keystroke, turn
off `Windows → Appearance → Switch when the modifier is released`.

Minimized windows and windows of hidden apps stay out of the list, again like ⌘⇥.
`Show hidden and minimized windows` in the same section brings them back.

**Three layouts to choose from** (`Windows → Appearance → Style`):

- `Grid` — windows in two rows, page by page.
- `Carousel` — the selected window large and centered, its neighbors angled behind
  it. This is the default.
- `List` — every window as a plain list with no thumbnails, so it opens without
  waiting for them.

You can also switch layouts from inside the switcher itself — your choice is
remembered. `List text size` sets how big the text runs: `Normal`, `Large` or
`Larger`. It applies to the list layout and to the application window list below;
bigger text also widens those panels.

---

## The windows of one app

The switcher walks every window on the Mac. This one stays inside the app you are
working in: hold ⌥ and press the key above Tab, and a compact list of that app's
windows appears. It carries no thumbnails, so there is nothing to wait for. Press the
shortcut again to step down the list, release ⌥ to switch, Esc to close.

Turn it on in `Windows → Application Windows → Enable application window list`; off by
default, like every shortcut DockView adds. **The default shortcut is ⌥ and the key
above Tab** (` ` ` on most layouts), changed in the `Shortcut` field beside it.

---

## Quick window commands (Quick Windows)

A small panel in the middle of the screen that lays the current window out across
half the screen, a quarter, three columns, or the whole display.

The commands come from the app's own `Window` menu, so you get exactly what you're
used to seeing in that program: `Fill`, `Center`, `Zoom`, `Minimize`, plus
`Move & Resize` and `Full Screen Tile`. Apps without a `Window` menu won't open the
panel — you'll hear the system alert sound instead.

Turn it on in `Windows → Quick Windows → Enable quick window commands`; off by
default. **The default shortcut is ⌥⌘F**, changed in the `Shortcut` field beside it.

Inside the panel: the arrow keys pick a command, ↩ applies it, Esc or a click
elsewhere closes it.

---

## The DockView icon in the Dock and the app panel

Your own folder in the Dock: an icon that pops open a panel of apps — the ones you
put there yourself. The app launches and focus goes back to whatever you were working
in.

The icon is drawn as a folder full of apps so it reads as a folder in the Dock. You
can turn it on in either of two places — `System → Show icon in Dock` or the first
line of the `Dock Panel` tab, `Show the apps panel in the Dock`; it's the same
switch. Off by default. Clicking the icon again closes the panel.

You choose what's in the panel on the `Dock Panel` tab: drag apps in from the Finder
or add them with `+`, remove them with `−`, and drag the rows to reorder. It starts
out with a few system apps so you can see straight away how it works.

Worth knowing: there's only one such panel — you can't create several separate
folders. While the icon is showing, DockView 2 also appears in the ⌘⇥ app switcher.
And if you turn the setting off while the icon was kept in the Dock, it stays behind
as a shortcut — drag it out yourself.

---

## The menu bar icon

This is where you open settings (⌘,), this documentation, check for updates, send
feedback and quit. It also shows your license status and warns you if one of the
permissions is missing.

You can hide the icon: `System → Menu Bar → Show icon in menu bar`. To bring it back,
launch DockView 2 again from Applications or Spotlight — the settings window opens.

---

## Startup, updates and license

- `System → Startup → Launch at login` — start together with the system.
- `System → Updates → Check for Updates` — check for updates by hand; also available
  from the menu bar.
- `System → License` — your license status: trial, activated (with the address it was
  issued to), or not activated. Buying and managing the license starts here too.
- `System → About` — the app version.

---

## Where to find things in Settings

| Tab | What's there |
|---|---|
| Preview | what appears when you hover the Dock — the panel or App Exposé — and when; how fast it appears, which windows are listed, windows from other desktops, minimized windows, full-size preview, resetting settings |
| Appearance | how the panel looks: theme, animation and speed, thumbnail size, distance from the Dock, button style on thumbnails |
| Stage | previews for Stage Manager groups, their gap and delay |
| Dock | numbers on icons, what clicking an icon does |
| Windows | the window switcher, the application window list and quick window commands |
| Dock Panel | the apps in your Dock panel |
| Permissions | permissions and re-running the first-launch steps |
| System | license, launch at login, Dock and menu bar icons, updates, version |

---

## Previews for Stage Manager groups (beta)

With Stage Manager on, your windows collapse into a strip at the edge of the screen,
and the shrunken cards rarely tell you what is in a group. Point at a group in the
strip and you get the same thumbnail panel a Dock icon gives you, with the same jump
straight to the window you want.

Turn it on in the `Stage` tab, `Preview Stage Manager groups (Beta)`; off by default.
Stage Manager itself has to be on in System Settings, or there is nothing to point at.

Two panel settings live in the same tab, separate from the ones for Dock previews:

- `Gap` — the distance between the Stage Manager strip and the panel, from -60 to 80
  points, 12 by default. A negative value pulls the panel over the strip.
- `Delay` — how long you keep the pointer on a group before the panel appears, from
  0.05 to 1 second, 0.1 by default. That is shorter than the delay for Dock icons,
  because the strip is narrow and the pointer crosses it quickly.

The feature is in beta. One known limit: the full-size preview of a window from a group
sometimes arrives tilted and blurred, which is how the system hands it back while the
window sits in the strip.

---

# MultiDock 2 Documentation — Mac Panels for Apps and Files

Product: MultiDock — https://noteifyapp.com/multidock/
Updated: 2026-09-01

How MultiDock 2 works: extra macOS panels for the apps, files and folders you use together — tabs, groups, running apps, placement and settings.

MultiDock 2 adds extra panels to macOS for the apps, files, and folders you use
together. The panels live alongside the Dock, not instead of it: pin one to a
screen edge, or let it float where the work is.

---

## Getting started

MultiDock lives in the **menu bar** at the top of the screen, near Control Center. It has no icon in the Dock unless you turn one on in `Settings… → General → Show icon in Dock`.

1. Click the MultiDock menu bar icon → `New Panel`. A panel appears on the screen where your pointer is.
2. Add apps, files, or folders: drag them onto the panel, or right-click empty space → `Add Item…`.
3. Click an item to open it, just like in the Dock.

---

## Panels

A panel is a window of icons. You can have several, including on different displays. The panel name is not drawn on the panel itself. It appears in the menu bar under `Panels`, so you can tell them apart.

Right-click empty space on a panel for:

- `New Panel`
- `Show All Panels`: brings every panel in front of other windows for a moment
- `Add Item…`
- `New Group`
- `New Tab`
- `Panel Settings…`
- `Remove Panel`: deletes the panel and everything in it. If the panel is not empty, MultiDock asks first.

`Show All Panels` is also in the menu bar. `Show Panel` (under `Panels` → the panel’s name) brings that one panel to the front.

`Remove Panel` removes a panel and its icons (MultiDock asks first if it isn’t empty). To clear every panel from the screen at once, `Quit MultiDock`: they come back the next time you open the app.

---

## Tabs

A tab is a full set of icons. Switching tabs changes the whole panel, like a browser.

The tab bar appears after you create a second tab and then stays, even if you go back to one tab. Removing the last tab empties the panel; the panel itself remains.

Right-click a tab:

- `New Tab`
- `Rename`: edit the name in place
- `Color`: `No Color`, or Red, Orange, Yellow, Green, Mint, Teal, Cyan, Blue, Indigo, Purple, Pink, Brown, Gray (system colors)
- `Show Running Applications`: on or off for this tab only
- `Remove Tab`

If the tab bar is hidden (a panel that has never had a second tab), the tab name is in `Panel Settings…` as `Tab Name`.

Default names: first tab `Main`, then `Tab 2`, `Tab 3`, …

---

## Groups

A group is one icon that opens a small window of shortcuts. The rest of the panel stays put. That is the difference from a tab: a tab replaces the set, a group opens on top of it.

Right-click empty space → `New Group`. Click the group to open it, or right-click the group → `Open`. Press Esc to close it.

A group holds shortcuts. Dropping a folder on the panel adds a shortcut to that folder.

Right-click a group to open it, rename it, give it a custom icon (`Choose Icon…`), or remove it.

Inside an open group: drag items in, or `Add Item…`. Right-click a shortcut in the group to give it a custom icon or take it out of the group.

---

## Adding and removing items

- Drag apps, files, or folders onto the panel or into a group.
- `Add Item…` opens the system file dialog.
- An empty panel shows a plus button and, on a horizontal panel, the hint `or drop apps here`.
- Right-click a shortcut → `Choose Icon…` to use your own image (any image file; MultiDock says so if it isn’t one). After you set a custom icon, `Use Default Icon` appears to bring back the original.
- Right-click a shortcut → `Remove` to take it off the panel. If that app is running and showing in the running-apps tail, the command is `Unpin`: the shortcut leaves the pinned set and can reappear among running apps.

Once the panel has items, add more by dragging them in or with `Add Item…` from the context menu.

---

## Running apps

Each tab can show applications that are open right now, after the pinned icons. Turn it on with `Show Running Applications` on that tab.

Running apps are not saved in your layout. Duplicates of pinned apps are filtered out; a pinned app that is running shows a running indicator instead of a second icon.

To pin a running app: drag it into place, or right-click it → `Keep in Panel`.

---

## Placement

`Panel Settings…` → `Position`:

- `Free`: the panel sits where you drag it. `Edge`, `Alignment`, and `Edge Inset` are grey. That is expected: a floating panel has no screen edge.
- `Snapped to Edge`: the panel sticks to a screen edge.

`Edge`: `Left`, `Right`, `Top`, `Bottom`. `Left` or `Right` makes a vertical column of icons; `Top` or `Bottom` makes a row.

Want a column and a row at the same time? Use two panels: snap one to `Left` or `Right`, the other to `Top` or `Bottom`.

`Alignment` along that edge: `Start`, `Center`, `End`, or `Stretch` (fill the edge).

`Edge Inset`: gap from the snapped edge only (0 to 48). It does not inset the other sides.

MultiDock remembers a panel's display and placement, but not its absolute coordinates, so a resolution change does not throw it off-screen. If that display is gone, the panel moves to one that is still there.

`Show on All Desktops`. On (default): the panel is on every Space and over full-screen apps. Off: it stays on the Space where it is. After you quit and reopen it, a single-Space panel comes back on the Space that is active when MultiDock starts. That is a macOS limitation.

`Window Level`: `Below Windows`, `Normal`, or `Above All`. The same choices are under `Panels` → the panel’s name → `Window Level`.

---

## Panel settings

Right-click the panel → `Panel Settings…`. Changes apply immediately; there is no Apply button.

| Setting | What it does |
|---|---|
| `Name` | Name in the `Panels` menu, not drawn on the panel |
| `Tab Name` | Only when the tab bar is hidden |
| `Position` | `Free` or `Snapped to Edge` |
| `Edge` | `Left`, `Right`, `Top`, `Bottom` (grey when `Free`) |
| `Alignment` | `Start`, `Center`, `End`, `Stretch` (grey when `Free`) |
| `Edge Inset` | Gap from the snapped edge (grey when `Free`) |
| `Window Level` | `Below Windows`, `Normal`, `Above All` |
| `Show on All Desktops` | Every Space, or only the current one |
| `Show Labels` | Names under icons |
| `Icon Size` | `Small`, `Medium`, `Large` |
| `Icon Spacing` | `Extra Compact`, `Compact`, `Normal`, `Spacious` |
| `Highlight on Hover` | Highlight when the pointer is over an icon |
| `Show Tooltips` | Name on hover (works even when the panel is not the key window) |
| `Tab Style` | `Buttons` or `Tabs` (slanted chips) |

Tab color is on the tab’s context menu, not in this window. `Show Running Applications` is on the tab, not here.

---

## Settings

Menu bar icon → `Settings…` (or ⌘,). This window is not Panel Settings. Panel settings still live on each panel (right-click → `Panel Settings…`).

**General**

- `Show icon in Dock`: off by default. The menu bar icon is always there.

**Startup**

- `Start at Login`: opens MultiDock when you log in to the Mac.

---

## Menu bar


- `New Panel`
- `Import from MultiDock 1…`
- `Show All Panels`: appears once you have at least one panel
- `Panels`: appears once you have a panel; lists each one by name (`Show Panel`, `Window Level`)
- `Settings…`
- `Check for Updates…`
- `Send Feedback…`
- `More Apps by MacPlus…`
- `License: Trial` / `Active` / `Not Activated`, then `Enter License Key…` or, once active, `Manage License…`
- `Quit MultiDock`

---

## License

MultiDock is a free trial that becomes a paid license with a key. The license lives in the menu bar, under the `License:` status line.

**Status line**: one of:

- `License: Trial`: the trial is running.
- `License: Active`: activated. A `Licensed to:` line shows the email the key belongs to.
- `License: Not Activated`: the trial is over and no key is entered.

**Enter a key.** Menu bar icon → `Enter License Key…`. This opens the activation dialog. Paste the key and confirm. When it succeeds, the status line turns to `License: Active`.

**Check or copy your key.** Once active, menu bar icon → `Manage License…` opens the License Manager window: status, the email the license is registered to, and the full `License Code` with a `Copy` button.

**Deactivate.** In the License Manager window → `Deactivate…`. This frees the license on this Mac. You can activate the same key again later, on this or another Mac.

**Move to another Mac.** There is no separate transfer. Deactivate on the old Mac (`Manage License… → Deactivate…`), then on the new Mac choose `Enter License Key…` and enter the same key.

A MultiDock 1 key does not work in MultiDock 2.

---

## Import from MultiDock 1

MultiDock 1 and MultiDock 2 are separate apps. Panels do not appear automatically.

Update first (`Check for Updates…`), then menu bar icon → `Import from MultiDock 1…`.

A MultiDock 1 license does not activate MultiDock 2.

---

## Keyboard shortcuts

| Shortcut | Action |
|---|---|
| ⌘, | Open `Settings…` |
| ⌘Q | `Quit MultiDock` |
| Esc | Close an open group |

---

## Troubleshooting

**I don’t see MultiDock.** It lives in the menu bar, not the Dock. To also show a Dock icon, turn on `Settings… → General → Show icon in Dock`.

**My MultiDock 1 panels aren’t here.** MultiDock 1 and MultiDock 2 are separate apps and do not share data. Update MultiDock 2 (`Check for Updates…`), then use `Import from MultiDock 1…`.

**I have a license key but can’t find where to enter it.** Menu bar icon → `Enter License Key…`. The status line above it shows `License: Trial` until you activate.

---

## System requirements

macOS 15 Sequoia or later, Intel or Apple Silicon.

---

# SuperTab 7 Documentation — Panel, Rows, Clipboard and Shelf for Mac

Product: SuperTab 7 — https://noteifyapp.com/supertab/
Updated: 2026-10-14

How SuperTab 7 works: the panel on the hotkey, rows and their sources, tabs, clipboard history, plugins and widgets, permissions, licence and troubleshooting.

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](https://noteifyapp.com/supertab/documentation/plugins/) and
[widgets](https://noteifyapp.com/supertab/documentation/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](https://noteifyapp.com/supertab/).
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](#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.**

- In the first-launch wizard, on the **Accessibility Access** step, press **Request Access** and enable SuperTab 7 in the system dialog.
- Later, from the menu bar: click **Open System Settings…** in the warning row, or open **Settings… → Permissions**, find **Accessibility**, and press **Open**.

**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.**

- In the wizard, on the **Screen Recording Access** step, press **Request Access** and enable SuperTab 7 in the system dialog.
- Later, from the menu bar: click **Open System Settings…** in the warning row, or open **Settings… → Permissions**, find **Screen Recording**, and press **Open**.

**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:

- In the wizard, on the **Recent Items Access** step, press **Open Settings**, then enable SuperTab 7 in the list that opens.
- Later, open **Settings… → Permissions**, find **Full Disk Access (recent items)**, and press **Open**.

### 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:

- **Accessibility** — with a green ✓ or a red ✗ and an **Open** button.
- **Screen Recording** — same.
- **Full Disk Access (recent items)** — same.
- **Refresh** button at the bottom.

**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.

### Hot corner

You can also open the panel by moving the pointer into a corner of the screen. Open **Settings… → General** and pick the corner next to the hotkey: one of the four corners, or **Off**.

### 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 → Hotkey**.

Notes about this setting:

- It works with the modifiers of your hotkey: with ⌘⇧K, releasing ⌘⇧ activates the selection.

- Releasing only fires once per open. Opening the panel with the modifiers already up (for example, if you clicked **Show SuperTab** from the menu bar) does not trigger it.

### Closing the panel

The panel closes on any of these:

- **Escape** — if a Quick Look preview is on screen, the first Escape closes Quick Look and the second closes the panel.

- **Click outside the panel** — a click in another app's window, the desktop, or the Dock closes SuperTab. Dragging a file into the panel is not a click, so it does not close it.

- The **esc** button in the top-right corner of the panel does the same as pressing Escape.

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:

- **Tabs** at the top (or on the side, or hidden — see [Tabs](#tabs)). Each tab holds its own set of rows.
- **Rows**, stacked vertically, one per data source: apps, windows, clipboard, custom items, and so on.
- **Tiles** inside each row: one app, window, file, or clipboard entry per tile.

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

- **←** and **→** — previous / next tile in the current row. At the edge of a row, if the neighbouring row has tiles, the selection moves there; otherwise it stops at the first tile (←) or the last tile (→) of the current row.
- **↑** and **↓** — move up or down one row, keeping roughly the same column.
- **Tab** — next tile in the current row, wrapping around.
- **Shift+Tab** — previous tile in the current row.

#### Move between tabs

- **⌘1** … **⌘9** — jump to a specific tab.
- **⌘←** and **⌘→** — cycle through tabs.

#### Actions on the selected tile

- **Return** — activate: open the app, switch to the window, put the clipboard entry back on the clipboard (and paste it into the app you were using, when **Paste into the active app on select** is on), or open the file.

- **Space** — Quick Look on a file, or a live preview popover on a window or clipboard entry. Space again dismisses it. Escape closes an open Quick Look preview (see Closing below); the hover popover for windows and clipboard entries is dismissed by Space, by moving the selection to a different tile, or by moving the cursor off the tile.


- **Delete** / **Forward Delete** — **Remove** in rows that support it: clipboard entries, custom items and drop shelf.

#### Closing

- **Escape** — first press dismisses an open Quick Look preview; the next press closes the panel.

### Mouse and trackpad

- **Click** a tile to activate it. One click is enough, even when another app is in front.

- **Right-click** a tile to see the actions available for that row (Close Window, Quit, Remove, Show in Finder, Pin / Unpin — depending on the row type).

- **Hover** a tile to see a live preview when the corresponding option is on (see [Appearance](#appearance)).

- **Drag a tile out** of the panel into Finder or another app when the tile represents a file (Custom Items, Drop Shelf, Recent Items, Folder).

- **Drag files into a row** that accepts drops. Custom Items accepts files, folders, and apps. Drop Shelf accepts files and images (an image copied from a web browser, for example). While you drag a file over a row that accepts it, the row is outlined — and you can drop it anywhere in the row, not only onto a tile.

### 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:

- **Active screen** — the display where your mouse pointer is.
- **Primary screen** — your main display.
- **Specific screen** — pick a named display from the list.

## 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:

- **Double-click** the tab name in the tab bar.

- **Right-click** the tab and choose **Rename tab**.

- If the tab bar is hidden, click the tab name in the panel header and choose **Rename tab…**.

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.

- **Right-click the tab → Icon…** to open the icon picker. Pick a symbol from the grid, or choose **Automatic** to go back to the default icon.

- With the tab bar hidden, use the panel header menu → **Icon…** instead.

**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… → Appearance → 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:

- **Right-click the tab → Delete tab** in the tab bar. The tab and its rows are removed right away — the context menu deletes the tab without a confirmation dialog.

- With the tab bar hidden, click the tab name in the header and choose **Delete tab**. Confirm to delete.

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… → Appearance → Panel → Tabs** and pick where the tab bar lives:

- **Top** — a horizontal strip above the rows. This is the default.
- **Left** — a vertical strip along the left edge.
- **Right** — the same strip, mirrored to the right edge.
- **Hidden** — no tab bar. Switch tabs with ⌘1…9 or by clicking the tab name in the panel header.

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:

- **Type** — change what the row shows. See "Row types" below.
- **Tile size** — Small, Medium, or Large. Each row has its own size; you can mix them.
- **Color** — a tint for the row background. Choose from No color, Red, Orange, Yellow, Green, Teal, Blue, Purple, Pink, or Gray. **Apply to All Rows**, the last item in this section, gives every row in every tab the color of this one.
- **Delete row** — remove the row. macOS asks you to confirm before the row is removed.

Some row types add their own actions to the menu — **Choose Folder…** and the sort order 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:

- **Close Window** — right-click → **Close Window**.

#### 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 actions:

- **Show in Finder** — right-click → **Show in Finder**. Reveals the app in Finder.

- **Quit** — right-click → **Quit**.

#### 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.

#### Launcher

The apps you start most often — this row holds apps only. Add an app with **Add App…** in the row menu, or drag it in from Finder. Running apps show a dot, like in the Dock.

#### Recent Applications

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

Row-specific actions:

- **Show in Finder** — right-click → **Show in Finder**. Reveals the app in Finder.

- **Remove** — right-click → **Remove**. The app disappears from the row and comes back when you open it again.

If the row is empty, grant [Full Disk Access](#full-disk-access-recent-items).

#### Recent Items

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

Each tile shows a preview of the file itself, made by Quick Look. If Quick Look has no preview for a file, the tile shows its icon. When **Show preview on hover** is on, hovering a file shows its name and full path under the picture.

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

Row-specific action:

- **Remove** — right-click → **Remove**. The document disappears from the row and comes back when you open it again.

If the row is empty, grant [Full Disk Access](#full-disk-access-recent-items).

#### 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:

- **Pin / Unpin** — right-click → **Pin / Unpin**. Pinned entries stay at the top of the list and are not evicted when the history limit is reached.

- **Remove** — right-click → **Remove**, or press **Delete** with the tile selected. Deletes the entry from history.

More in [Clipboard history](#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:

- Click the **+** on the row's header, then pick files, folders, or apps in the Open panel that appears.

- Drag files or folders onto the row from Finder.

Row-specific actions:

- **Rename…** — right-click → **Rename…**. In the **Rename Item** window type a new name and click **Rename**. Only the name of the tile in the row changes; the file on disk keeps its name. Clear the name and click **Rename** to go back to the file's own name.

- **Remove** — right-click → **Remove**, or press **Delete**. Deletes the entry from the row. The file on disk is not touched.

- **Show in Finder** — right-click → **Show in Finder**. Reveals the file in Finder.

You can drag a tile out of Custom Items into Finder or any other app to drop the file there. A file dropped into Finder is copied under its own name.

#### 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 actions:

- **Choose Folder…** in the row menu opens an Open panel where you can pick a different folder. Once you pick one, the row shows its contents and the row name changes to the new folder's name.

- **Sort order** — right under **Choose Folder…** in the row menu: **Sort by Date Added**, **Sort by Date Modified**, **Sort by Name** or **Sort by Kind**. The current order has a checkmark. The default is **Sort by Date Added**, newest first.

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](https://noteifyapp.com/supertab/documentation/plugins/).

#### 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](https://noteifyapp.com/supertab/documentation/widgets/).

#### 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:

- **Remove** — right-click → **Remove**, or press **Delete**. Removes the entry from the shelf.

- **Show in Finder** — right-click → **Show in Finder**.

Row-specific action:

- **Clear Drop Shelf** in the row menu — removes all entries at once.

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. A file dropped into Finder is copied under its own name.

## Appearance

Open **Settings… → Appearance**. The **Panel** section changes how the panel looks; the **Language** section sets the language of SuperTab itself.

### Interface language

**Settings… → Appearance → Language → Interface language** has eleven options: **System**, English, Deutsch, Español, Français, Italiano, Nederlands, Polski, Português (Brasil), Українська and 日本語. The change takes effect right away. With **System**, SuperTab follows the language order in System Settings; **Open Language & Region…** opens that page.

### Appearance (theme)

Three options:

- **Auto** — match the system.
- **Dark** — always dark.
- **Light** — always light.

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

### Panel size

Five sizes, in this order:

- **Compact** — the tiles and everything around them are smaller still.
- **Small** — a narrower panel with smaller tiles.
- **Medium** — the default.
- **Large** — a wider panel with larger tiles.
- **Full Width** — the panel stretches across the whole screen, like in SuperTab 5.

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:

- **Solid** — one glass slab holds the tabs and every row together. This was the classic look.
- **Floating rows** — no shared slab. The tab bar (or side tabs) and each row become their own glass capsule with a shadow, and the spaces between them are transparent.

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

### Dim background

The **Dim background** slider, right under **Panel background**, darkens the screen behind the panel while it is open — from 0 to 80%. At 0%, the default, nothing is dimmed. Click the dimmed area to close the panel.

### 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… → Appearance → Panel** has a **Show preview on hover** toggle.

- On (the default) — hovering a tile pops a live preview above it: the current window frame for a window tile, the contents of a clipboard entry, or a Quick Look–style thumbnail for a file.

- Off — the extra hover popover is suppressed. Tiles themselves still draw their own visuals — windows keep their thumbnail, clipboard tiles keep their content preview, files keep their thumbnail — only the popover is gone.

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](#actions-on-the-selected-tile).

## Clipboard history

SuperTab 7 keeps a history of what you copied. Entries appear in the **Clipboard History** row on the panel (see [Rows](#clipboard-history)); 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:

- **Text** — plain text.
- **Image** — an image copied to the clipboard.
- **Files** — one or more file paths.

### What is skipped

- **Concealed or transient copies.** Password managers and similar apps mark a clipboard entry as private. SuperTab skips those entries entirely.

- **Items larger than 10 MB.**

- **Copies from excluded apps.** By default the excluded list holds 1Password, Bitwarden, Keychain Access, and the built-in **Passwords** app. When the frontmost app is on the list, its copies are not saved.

### 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

- **Click** a tile or press **Return** — same as "Paste into the active app on select" above.
- **Space** on a clipboard tile — opens a preview: full text for a text entry, the full image for an image entry, or a short list of copied file names for a files entry. Space again dismisses it.

### Managing entries

- **Pin / Unpin** — right-click a tile → **Pin / Unpin**. Pinned entries stay at the top of the row and survive the history limit.

- **Remove** — right-click → **Remove**, or press **Delete** with the tile selected. Removes just that entry.

- **Clear history** — **Settings… → Clipboard → Clear history**. This deletes every entry, including pinned ones, after you confirm.

## License

### Status in the menu bar

The License section of the menu bar item shows:

- **License: Active** — SuperTab 7 is activated on this Mac.
- **License: Trial** — SuperTab 7 is running in trial mode.
- **License: Not Activated** — SuperTab 7 is not activated on this Mac.

### 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:

- **Status**
- **Licensed To** — your email.
- **License Code** — with a **Copy** button.
- **Deactivate…**

### 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:

- *The settings file could not be read. Changes will not be saved until the app is restarted.* — Restart SuperTab. If the banner comes back, see [Start over with default tabs and rows](#start-over-with-default-tabs-and-rows).
- *The settings file was written by a newer version of the app. Changes will not be saved.* — Update SuperTab 7.

### 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](#permissions).

**Recent Applications and Recent Items are empty.**
Grant Full Disk Access in **Settings… → Permissions → Full Disk Access (recent items)**. See [Permissions](#full-disk-access-recent-items).

### Hotkey

**What is the default hotkey?**
⌥Tab (Option + Tab). See [Hotkey](#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](#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 → Hotkey**. See [Hotkey](#releasing-the-modifier-to-pick-the-selection).

### Panel, tabs, and rows

**Can I change the size of the panel?**
Yes. Choose **Compact**, **Small**, **Medium**, **Large** or **Full Width** in **Settings… → Appearance → Panel → Panel size**. See [Appearance — Panel size](#panel-size).

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

- **Applications** — quit the app (right-click → **Quit**).
- **Dock Items** — remove the app from your Dock.
- **Custom Items** — right-click → **Remove**, or press **Delete**.

See [Rows](#rows).

**Can I reorder rows?**
Yes. Drag the three-lines handle in the row header up or down. See [Panel — Reordering rows](#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](#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](#license).

### Updates

**What's new in the latest version?**
The update window shows the release notes for each new version. See [Updates](#updates).

### Something else

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

---

# SuperTab 7 Plugins — Live Info From Scripts on Your Mac

Product: SuperTab 7 — https://noteifyapp.com/supertab/
Updated: 2026-10-14

Plugins put live information into the SuperTab panel: CPU, memory, disk space, Git status. Same format as xbar and SwiftBar, so ready-made plugins work as they are.

Plugins add live information to your SuperTab panel: CPU and memory, free disk space, the status of your Git projects — or anything else a small script can print.

SuperTab reads the same plugin format as xbar and SwiftBar, so most ready-made plugins from their catalogs work here without changes. Plugins that lean on features beyond the basic format may need a small adjustment.


Screenshot: A Plugins row: the built-in plugins and the tile that adds more

## Add a Plugins row

Two ways:

- Click **Add row** at the bottom of the panel and choose **Plugins** from the menu of row types.
- Or click the name of a row you already have and choose **Type → Plugins**.

Screenshot: The Add row menu, with Plugins selected

The row shows the built-in plugins right away. Click a plugin to see more details and actions.

## Built-in plugins

- **System** — CPU, memory, and battery.
- **Disk** — free space on your disks.
- **Git** — how many of your projects have uncommitted changes. To choose the folder it watches, click the plugin, choose **Edit Plugin**, and change the folder on the first lines.

## The Plugins tile

Every Plugins row has one tile of its own, marked with a puzzle icon: **Plugins — Add or create →**. Click it and a menu opens:

- **New Plugin…**
- **Add Plugin…**
- **Get More Plugins…**
- **Open Plugins Folder**
- **How Plugins Work** — this page.

Screenshot: The menu behind the Plugins tile

## Add more plugins

### A ready-made plugin from the catalog

1. Click the row name and choose **Get More Plugins…**. The xbar plugin catalog opens in your browser.
2. Open a category — for example **Dev** or **System** — and click the plugin you like. You'll see its file, ending in `.sh`, `.py`, or similar.
3. Click the **Download raw file** button (the arrow icon above the code) to save the plugin to your Downloads folder.
4. Back in SuperTab, click the row name and choose **Add Plugin…**, then select the file you downloaded.
5. The new plugin appears in the row with **New plugin — click to allow**. Click it and confirm.

The plugin starts showing its information within a few seconds.

Some plugins need a setting before they work — a folder, a city, or an account key. Their description in the catalog says so. Click the plugin, choose **Edit Plugin**, and fill it in on the first lines of the file.

### Your own plugin

Choose **New Plugin…** — from the Plugins tile or from the row menu. A window asks for two things:

- **Name** — what the plugin will be called.
- **Update every** — 10 seconds, 30 seconds, 1 minute, 5 minutes, or 1 hour.

SuperTab creates a ready-to-edit plugin in the row and opens the file in your editor. Change the text and save. Click the plugin and choose **Refresh** to see the result right away.

A plugin you created with **New Plugin…** keeps working after you edit it. A plugin that came from somewhere else — added with **Add Plugin…** or dropped into the folder — asks to be allowed again every time its file changes.


Screenshot: The row menu: row type, plugin actions, tile size and colour

## Manage plugins

Click a plugin to find:

- **Edit Plugin** — open it in your text editor.
- **Show in Finder**
- **Remove Plugin** — moves it to the Trash.
- **Refresh**

## Several rows of plugins

Each new Plugins row gets a folder of its own — **Plugins 2**, **Plugins 3** and so on — with its own copy of the example plugins. Removing a plugin in one row does not touch the others. The first Plugins row keeps the folder it always had. To point a row at a different folder, click the row name and choose **Choose Folder…**. To jump straight to a row's folder in Finder, choose **Open Plugins Folder** from the same menu. Each row can also have its own tile size.

## Plugins and widgets

A widget can read what a plugin already produced — that is how the built-in **plugin-bars** widget draws CPU, RAM and battery without running a script of its own. If you want to show a plugin's output as a drawing rather than as lines of text, see [how widgets work](https://noteifyapp.com/supertab/documentation/widgets/).

## Write your own plugin

A plugin is a small script that prints lines of text. The first lines — up to three — appear on the tile; everything after a `---` line appears when you click it.

```sh
#!/bin/sh
echo "Hello"
echo "---"
echo "Open SuperTab page | href=https://noteifyapp.com/supertab/"
```

The number in the file name sets how often it updates: `hello.1m.sh` runs every minute, `hello.10s.sh` every 10 seconds.

For the full format — colors, icons, menus, actions — see the plugin guide by SwiftBar:
https://github.com/swiftbar/SwiftBar#plugin-api

Browse ready-made plugins:
https://github.com/matryer/xbar-plugins

---

# SuperTab 7 Widgets — HTML Panels Inside the Switcher

Product: SuperTab 7 — https://noteifyapp.com/supertab/
Updated: 2026-10-14

Widgets are tiny web pages shown as tiles in the SuperTab panel: a clock, a calendar, live bars. Same format as the open-source Wigify project.

Widgets are tiny web pages — HTML, CSS, and a little JavaScript — shown as tiles in your SuperTab panel: a clock, a calendar, a live chart, anything a web page can draw.

SuperTab reads the same widget format as the open-source [Wigify](https://github.com/wigify/wigify) project, so most templates from its catalog work here without changes. A template that uses more than the basic format may need a small adjustment.


Screenshot: A Widgets row with the three built-in widgets

## Add a Widgets row

Two ways:

- Click **Add row** at the bottom of the panel and choose **Widgets** from the menu of row types.
- Or click the name of a row you already have and choose **Type → Widgets**.

Screenshot: The Add row menu, with Widgets selected

The row shows three built-in widgets right away. Right-click a widget to see more actions.

## Built-in widgets

- **world-clock** — the current time in three time zones.
- **calendar-week** — the current week, with today highlighted.
- **plugin-bars** — reads the output of the `system.30s.sh` plugin from a Plugins row and draws CPU, RAM, and battery as coloured bars. A small demo of the bridge to plugins (see below).

All three read only what is already on your Mac: the system clock and calendar, and the output of a plugin from a Plugins row.

## Add more widgets

### A ready-made widget from the catalog

1. Click the row name and choose **Get Widgets…**. The Wigify `widget-templates` catalog opens in your browser.
2. Download the template folder you like.
3. Back in SuperTab, click the row name and choose **Add Widget…**, then select the folder you downloaded.

The widget appears as a tile right away.

### Your own widget

Choose **New Widget…** and give it a name. SuperTab creates a folder with three ready-to-edit files — `widget.html`, `style.css` and `script.js` — and opens that folder in Finder. Edit the files, then right-click the tile and choose **Reload** to see the result.

## Manage widgets

Right-click a widget to find:

- **Reload** — reload the page.
- **Edit Widget** — opens the widget's folder.
- **Show in Finder**
- **Remove Widget** — moves the folder to the Trash.


Screenshot: Right-click a widget tile: Reload, Edit Widget, Show in Finder, Remove Widget

## Several rows of widgets

Each new Widgets row gets a folder of its own — **Widgets 2**, **Widgets 3** and so on — with its own copy of the example widgets. Removing a widget in one row does not touch the others. The first Widgets row keeps the folder it always had. To point a row at a different folder, click the row name and choose **Choose Folder…**. To jump straight to a row's folder in Finder, choose **Open Widgets Folder** from the same menu.


Screenshot: The row menu: row type, widget actions, tile size and colour

## Write your own widget

A widget is a folder with up to three files:

- `widget.html` — required.
- `style.css`, `script.js` — optional, referenced from the HTML the normal way.

```html
<!doctype html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <title>My widget</title>
    <link rel="stylesheet" href="style.css">
  </head>
  <body>
    <!-- Everything under <body> is your widget.
         The background is transparent so the SuperTab glass
         shows through — set your own if you need one. -->
    <h1 id="title">Hello, widget!</h1>
    <p id="subtitle">Edit widget.html to make it yours.</p>
    <script src="script.js"></script>
  </body>
</html>
```

Keep the background transparent in your CSS unless you want your own:

```css
html, body {
  margin: 0;
  padding: 0;
  background: transparent;
}
```

## The bridge to plugins

A widget can read the parsed output of a plugin from any Plugins row with `window.supertab.plugin(name)` — see [how plugins work](https://noteifyapp.com/supertab/documentation/plugins/) for what a plugin is and how to add one. Only plugins you have already allowed in a Plugins row are available to a widget. If that Plugins row has a recent result, the widget gets it; if not, SuperTab runs the plugin the same way the Plugins row does. A widget cannot run a plugin you haven't allowed, or any other script.

```html
<script type="module">
  const out = await window.supertab.plugin("system.30s.sh");
  // out.header — the tile lines (each with color/icon/font)
  // out.menu   — the menu items after the first `---`
</script>
```

`await` at the top level needs `type="module"`. In a plain `<script>` wrap the call instead: `(async () => { … })();`

`window.supertab.onRefresh(callback)` registers a callback that fires whenever a plugin the widget reads gets a fresh result.

## More

Browse ready-made widget templates:
https://github.com/wigify/wigify/tree/main/widget-templates