All features

Everything GroupShelf can do, in one place. Features added in v1.6.0 are marked NEW, and features you turn on in Settings before using them are marked “Turn on in Settings”.

The free version has every feature on this page.After the 30-day trial, GroupShelf keeps working as the free version, with 1 group of up to 3 tabs.

Create groups

How to gather windows into tabs, and the settings for how they’re grouped.

Shift-drag to groupsince v1.0.0

Hold Shift and drag a window onto another. When a preview appears over the target, let go: the two windows become one group, with a tab bar on top. Drop it onto an existing group’s tab bar instead and it joins that group as a tab. You can change the key and how long the preview takes to appear in Settings.

How to useHold Shift, drag a window by its title bar onto another window or a tab bar, and let go when the preview appears. To change the key and the timing, go to Settings → “Grouping” → “Group by Dragging”: “Modifier Key” (Shift, Control, Option or “None (always on)”) and “Preview Delay” (“Instant” to “1 s”).

Add windows from the + buttonsince v1.0.0Multi-select since v1.4.1

No dragging needed: the + in the tab bar adds windows to the group. It lists your open windows; tick the ones you want and add them all at once. Even a window that’s awkward to drag onto the group is just a pick from the list.

How to useClick + in the tab bar (“Add window to group”), tick the windows to add, then choose “Add N Windows” at the end of the list.

Group all of an app’s windows at oncesince v1.0.0

Pulls every open window of a tab’s app into that tab’s group in one go. Handy when Finder or Terminal windows are scattered all over the screen.

How to useRight-click a tab and choose “Group All Windows of This App”.

Auto-Grouped AppsTurn on in Settingssince v1.5.0

For an app in this list, just opening a new window puts it into a group of the same app on the same desktop. If there’s no such group yet, the window starts one with another window of that app. Windows without a full-screen button, such as palettes and dialogs, stay out. To keep small windows out too, you can set a minimum width.

How to useIn Settings → “Grouping” → “Auto-Grouped Apps”, pick apps with “Add from Running Apps…”. Change the minimum width with “Leave out windows narrower than N pt”.

Merge two groupssince v1.0.0By dragging a tab since v1.6.0

Combine two groups into one, keeping every tab. Drag one group’s tab bar, or any of its tabs, onto the other group’s window or tab bar and let go: all its tabs join the end of that group. It works just like grouping a window by dragging it.

How to useHold the modifier key (Shift by default), drag an empty part of a tab bar, or one of its tabs, onto another group’s window or tab bar, and let go when the preview appears. If you dragged a tab, it comes to the front.

Works with any app’s windowssince v1.0.0

Mix windows from any app that has them in the same group: Finder, Terminal, browsers, editors, Office, Electron apps and more. Web apps installed from Chrome show the page title on their tab, too.

How to useNothing to set up.

Excluded Appssince v1.0.0

Keep out apps you never want grouped. Windows of an excluded app don’t become tabs, even when dropped onto another window. System Settings is excluded from the start.

How to useIn Settings → “Grouping” → “Excluded Apps”, pick apps with “Add from Running Apps…”.

Work with tabs

Switching, reordering and taking out tabs, and what the tab bar can do.

Switch windows with tabssince v1.0.0

Click a tab to bring its window to the front. The tab bar sits just outside the window’s top edge, so it never covers the app’s title bar or toolbar. For a window pushed up to the top of the screen, the tab bar is shown over the top of the window instead.

How to useClick a tab in the tab bar.

Reorder tabs or move them to another groupsince v1.0.0

Drag a tab left or right within the tab bar to reorder it. Drag it onto another group’s tab bar to move it to that group.

How to useDrag the tab.

Take a tab out of its groupsince v1.0.0Opens where you let go since v1.6.0

A tab you take out goes back to being an ordinary window; the window doesn’t close. Drag a tab off the tab bar and its window opens where you let go; while you drag, a blue area shows where and how large it will be. When a group is down to one tab, the group is dissolved.

How to useDrag the tab off the tab bar and let go, click the tab’s ↗ (“Detach from group”), or right-click the tab and choose “Pop Tab Out”.

Close windows or dissolve a groupsince v1.0.0

Close a tab’s window from the tab, or close all of a group’s windows at once. If a document has unsaved changes, the app asks as it always does. Dissolving a group leaves its windows open and turns each one back into an ordinary window.

How to useMiddle-click a tab, or right-click it and choose “Close This Tab’s Window”. For the whole group, right-click a tab or the tab bar and choose “Close All Windows in the Group” or “Dissolve Group”. To dissolve every group at once, choose “Dissolve All Groups” in the menu bar.

Tab bar buttonssince v1.0.0Tooltips since v1.5.0

Buttons for working with the group sit right after the tabs, in this order: move to another display (with two or more displays), tab search (when turned on), Split View, and add a window. Hover over each one to see what it does.

How to useHover over a button to see “Move to another display”, “Search tabs”, “Open Split View” or “Add window to group”.

Buttons at the right endNEWTurn on in Settingssince v1.6.0

Line up the group’s buttons at the right end of the tab bar instead, so they stay in the same place however many tabs there are. The + button stays right after the tabs, where the next tab goes.

How to useIn Settings, under “Tab Bar”, set “Button Position” to “Right Edge”.

When tabs don’t fitsince v1.4.0

Once there are more tabs than fit in the tab bar, the tab titles shrink first. The group name stays in view, so you can always tell which group it is.

How to useNothing to set up.

Move the whole group

A group moves like a single window.

Moves together, one sizesince v1.0.0

Drag any window in a group and the whole group follows. Resize it, and every tab’s window takes the same size. Switching tabs keeps the position and size as they are.

How to useDrag a window’s title bar, or an empty part of the tab bar.

Maximize and minimizesince v1.0.0

Double-click an empty part of the tab bar and the whole group maximizes, just as it does from a title bar. A maximized group still leaves room for the tab bar, so the bar never goes off the screen. The yellow button on a window minimizes only that tab’s window.

How to useTo maximize, double-click an empty part of the tab bar. To bring back a minimized tab, click the tab or use the Dock.

Full screen and other Spacessince v1.0.0

When a tab’s window enters full screen or moves to another Space, you choose whether it stays in the group as a tab or leaves the group. If it stays (the default), it rejoins its group when it comes back.

How to useIn Settings → Grouping → Group Behavior, choose “Keep Tab (suspend)” or “Remove from Group” for “When Entering Full Screen” and “When Moved to Another Space”.

Follows ⌘Tab, the Dock and app tabssince v1.0.0

Pick a hidden tab’s window with ⌘Tab or the Dock, and the group switches to that tab. Switching an app’s own tabs (⌘T), as in Finder, leaves the group intact, and the group’s tab points to whichever app tab is now showing.

How to useNo action needed.

Move to another displaysince v1.0.0

Move a whole group to another display. Push the tab bar against the edge of the screen and a label shows where it will go; let go, and the group moves to the next display. A group always stays within one display and never spans two.

How to useClick the “Move to another display” button in the tab bar and choose where to go, or right-click a tab or the tab bar and choose “Move to Display”. The button appears when you have two or more displays.

After sleep or reconnecting a displaysince v1.0.0Waits for the display since v1.4.1

When the Mac wakes from sleep or you reconnect an external display, groups return to the display they were on. If a display takes a few seconds to reconnect, GroupShelf waits for it to come back instead of moving its groups to another display.

How to useNo action needed.

Groups survive app restartssince v1.0.0

When GroupShelf restarts for an update or a language change, your groups, group names, colors, tab names and Split Views carry over as they were. If some windows can’t be carried over, for example because they’re on another Space, GroupShelf tells you before restarting how many windows will leave their groups.

How to useNo action needed.

Split View

Shows two tabs of a group at once, side by side or one above the other.

Two tabs side by sidesince v1.5.0

Show two of a group’s tabs side by side, to write with a reference open or to edit one thing while comparing it with another. Once paired, the group still moves as one unit, as before. Paired tabs are outlined in the tab bar.

How to useRight-click a tab, choose “Show in Split View With”, then choose the tab to put beside it.

The Split View buttonsince v1.5.0

Start a Split View from a button in the tab bar by choosing a window for each side. You can choose not only this group’s tabs but also windows that aren’t in any group.

How to useClick the “Open Split View” button in the tab bar and choose the direction, then pick the windows with “Choose Left Window” and “Choose Right Window” (“Choose Top Window” and “Choose Bottom Window” for top and bottom).

Side by side or top and bottomNEWsince v1.6.0

Split a group top and bottom as well as side by side — handy on a portrait display, or for content that reads better wide. You choose the direction each time you open a Split View, or have it always open one way. An open pair can switch to the other direction, too.

How to useClick the “Open Split View” button in the tab bar and choose “Side by Side” or “Top and Bottom”. Select “Always open this way” to skip the question, or choose a direction in Settings → “Tab Bar” → “Split View Direction”. To switch an open pair, choose “Top and Bottom” or “Side by Side” from the menu at the right end of its tabs.

Resize with the dividersince v1.5.0

Drag the line between the two windows to change how much room each one gets. Double-click it to go back to half and half.

How to useDrag the line between the two windows, or double-click it.

Several Split Views, and exitingsince v1.5.0

A single group can hold several Split View pairs. Paired tabs stay together when you reorder them. When you exit a Split View, both tabs stay in the group as ordinary tabs.

How to useChoose “Exit Split View” from the menu at the right end of the paired tabs, or from a tab’s right-click menu.

Find & switch

Features that take you straight to the tab you want.

Switch tabs from the keyboardsince v1.0.0

Press Control + Option + ← → to step through the tabs of the group you’re working in — no need to reach for the mouse. You can change the keys to any combination you like, or turn them off if you don’t use them.

How to useIn Settings, under “Tab Bar” → “Tab-Switch Hotkey”, change “Next Tab” and “Previous Tab”. “Reset to Defaults” puts the original keys back.

Search your tabsTurn on in Settingssince v1.2.0

See every tab in your groups in one list with previews, filter by title, app or group name, and open the tab you pick right away. It finds minimized tabs and tabs in groups on another Space, too. Previews appear only if you allow Screen Recording; otherwise each tab shows its app’s icon.

How to useIn Settings, under “Tab Search”, turn on “Use tab search”. Then open it from 🔍 in the tab bar, “Search Tabs…” in the menu bar, or Control + Option + S. Change the keys with “Hotkey” on the same screen.

Keys and markers in Tab Searchsince v1.3.0

In Tab Search, ← → move within a group and ↑ ↓ move between groups. The tab each group is showing is marked “Active”, and a tab’s color shows as a line along the bottom of its preview.

How to useOpen Tab Search and move with the arrow keys.

Jump to a group from the menu barsince v1.0.0

GroupShelf’s menu in the menu bar lists your groups, with how many tabs each has and which tab it’s showing. Click one to bring that group to the front; if it’s on another Space, you switch to that Space too.

How to useClick the GroupShelf icon in the menu bar and choose a group from the “Groups” list.

Badges on your tabsTurn on in Settingssince v1.0.0

Tabs show the same numbers as the badges on their apps’ Dock icons, like unread counts from Slack or Mail, so you notice new notifications even on tabs hidden behind others. You can change the badge color, too.

How to useIn Settings, under “Tab Bar” → “Notifications”, turn on “Show app notification badges on tabs”. Change the color with “Badge Color”.

Spot & organize

Make groups and tabs easy to tell apart at a glance.

Group names and colorssince v1.0.0

A group’s name appears at the left end of its tab bar. Give each group a color, and you can tell the groups for different tasks apart at a glance.

How to useRight-click a tab or the tab bar and choose “Name Group…” (“Rename Group…” once it has a name) and “Group Color”. Leave the name blank to remove it.

Tab colorssince v1.0.0

Give each tab its own color. Pick a built-in color or any color you like, and save the ones you use often as color presets.

How to useRight-click a tab and choose from “Tab Color”. For any color, choose “Custom Color…”; to remove the color, choose “None (clear color)”. Add presets with “Add” under “Color” → “Tab Color” in Settings.

Auto-color rulessince v1.0.0

Set conditions on the app and the title, and tabs that join a group get their color automatically. Match the title with “Contains” or a regular expression — for example, to turn Terminal tabs whose title contains “prod” red.

How to useIn Settings, under “Color” → “Auto-Color Rules”, click “Add” and set “Target App”, “Title Condition” and “Color to Apply”. You can also get there by right-clicking a tab and choosing “Tab Color” → “Auto-Color Rules…”.

Rename tabssince v1.5.0

Give a tab any name you like. Even with several windows of the same app side by side, names like “Production” and “Staging” tell them apart. Leave the name blank to go back to the window’s title.

How to useRight-click a tab and choose “Rename Tab…”.

Lock a groupsince v1.0.0

Pin down a group you’ve set up so it doesn’t get broken up by accident. A locked group can’t gain or lose tabs or be merged with another group, and “Dissolve Group” and “Close All Windows in the Group” are unavailable. A lock icon shows in its tab bar while it’s locked.

How to useRight-click a tab or the tab bar and choose “Lock Group”. To unlock it, choose “Unlock Group” in the same menu.

Tab size and bold titlessince v1.4.0

One slider scales the tab bar along with the tabs’ icons, titles and widths and the bar’s buttons, up to almost twice the default size. To keep titles easy to read on a large display, you can also make them bold.

How to useIn Settings, under “Tab Bar”, adjust “Tab Size” between “Small” and “Large”, and turn on “Show tab titles in bold”.

Appearance and opacitysince v1.0.0

Have the tab bar follow the system appearance, or keep it light or dark. Lower its opacity to let what’s behind the bar show through.

How to useIn Settings, under “Tab Bar” → “Appearance”, choose “Match System”, “Light” or “Dark”, and adjust “Tab Bar Opacity”.

Command line

Control groups from your terminal app or a script with the groupshelf command.

Before you start, turn on “Allow control from the command line and scripts” in Settings → Command Line (it starts off). If you installed GroupShelf with Homebrew, the groupshelf command is installed with it; otherwise, the same page shows how to install it. The first time, macOS asks whether your terminal app may control GroupShelf.

Group in one line from the terminalTurn on in Settingssince v1.3.0Colors since v1.4.0

Name open windows by app, by app and part of the title, or by window ID, and group them with a single command. For an app you’ve just opened, it waits up to 30 seconds for its windows to appear. You can set the group’s name and color, and the tab color, in the same command.

How to useFor example: groupshelf group Safari Terminal or groupshelf group --name Work --color blue Code Terminal.
Command-line guide →

Add, detach and dissolveTurn on in Settingssince v1.3.0Tab colors since v1.4.0

The add command puts windows into an existing group, detach takes them out of their group, and ungroup dissolves a group. Windows you add can get a tab color too.

How to useFor example: groupshelf add --group Work Slack or groupshelf detach Slack.

List windows and groupsTurn on in Settingssince v1.3.0`--groups` and `--json` since v1.4.0

Lists the windows on this desktop, with their IDs. With --groups, it lists the groups on every desktop instead, with tab order and colors. With --json, it prints JSON you can hand to other tools and scripts.

How to useFor example: groupshelf list or groupshelf list --groups --json.

Change names and colors, show a tabTurn on in Settingssince v1.4.0

With set, you can change an existing group’s name and color, and its tab colors, afterwards. The show command shows a given window’s tab, just as clicking the tab does.

How to useFor example: groupshelf set --group Work --name Office or groupshelf show Code:proj-a.
AppleScript: Script Editor and osascript can do the same with commands such as group apps, add apps and list groups. The terminology is English only.

The app

How the app itself is built, and what helps you keep using it.

Native & lightweightsince v1.0.0

A native Mac app built with AppKit, without Electron. When idle, it uses almost no CPU, and its effect on your battery is minimal.

RequirementsRuns on macOS 15 or later.

Available in 10 languagessince v1.1.0

Menus, Settings and in-app guidance are available in 10 languages. You can choose one apart from your macOS language.

How to useChoose it under “Display Language” in Settings → General, then click “Restart Now” to switch.

Launch at loginsince v1.0.0

Opens GroupShelf automatically when you log in to your Mac.

How to useIn Settings → General, turn on “Launch at Login”.

Export and import settingssince v1.0.0

Save your settings to a file and load them on another Mac. When you move to a new Mac, you can start right away with the same settings. The file doesn’t include your license.

How to useIn Settings → General, under “Settings File”, click “Export…” or “Import…”. Importing replaces that Mac’s settings with the ones in the file.

Quick how-tosince v1.0.0

Look up the main actions right in Settings: making a group, switching tabs, moving a group as a whole, taking windows out, finding a tab and more.

How to useOpen Settings → How to Use.

Update noticessince v1.0.0Current notices since v1.4.1

Once a day, GroupShelf checks for a new version. When it finds one, its menu bar icon gets a “!” and a notice appears at the top of its menu. If the update is found right after launch, or has been out for a week or more, a window tells you as well. Before updating, you can read just the changes newer than your version.

How to useUpdate from “New version X.Y.Z available…” at the top of the menu. To check right away, click “Check for Updates” in Settings → About.

Send feedbacksince v1.2.0

Send bug reports and feature requests from your own email. Just copy the contact address and the diagnostics, and paste them into a message.

How to useChoose “Send Feedback…” in GroupShelf’s menu in the menu bar, then use “Copy Address” and “Copy Diagnostics”.

Manage your licensesince v1.0.0

Enter your license key, or deactivate the license on this Mac, right in Settings. One key works on up to 3 Macs.

How to useChoose “License…” in GroupShelf’s menu in the menu bar, or open Settings → License.
← Back to homeRelease notes →