Repolode
Submit
gechr

gechr/WhichSpace

A macOS menu bar utility that shows the active Space number and lets you switch or move windows between Spaces.

View on GitHub
Stars
860
Forks
47
Open issues
0
Last commit
22 hours ago

What is it?

WhichSpace sits in the macOS menu bar and displays the number of the Space you are currently on, so you no longer need to guess which desktop you are in. It can show only the active Space or every Space at once, and can include Spaces from all connected displays in a single menu bar item.

Clicking a Space in the menu bar switches to it, and scrolling over the icon cycles through Spaces. Keyboard shortcuts can switch Spaces or move the front window to another Space. Each Space can be styled with its own colors, icon style, SF Symbol or emoji, label, badge character, size and font.

WhichSpace also exposes automation through Shortcuts actions, AppleScript, and a whichspace:// URL scheme, so Spaces can be switched, labeled or configured from scripts and other apps. It requires macOS 14.0 or later and is installable via Homebrew.

Key features

  • 01Shows the current Space number, or all Spaces, in the menu bar
  • 02Includes Spaces from every connected display in one menu bar item
  • 03Click or scroll to switch Spaces; global keybinds switch or move windows
  • 04Per-Space colors, icons, SF Symbols, emoji, labels, badges and fonts
  • 05Shortcuts actions, AppleScript and URL scheme for automation

Use cases

  • Keeping track of which desktop you are on when using many Spaces
  • Jumping between Spaces quickly from the menu bar or with keyboard shortcuts
  • Labeling Spaces with names like Work or Mail for easier navigation
  • Automating Space switching or window moves from scripts and Shortcuts

Quick start

  1. 1

    Install with Homebrew

    brew install --cask whichspace
  2. 2

    Or download WhichSpace.zip from the releases page, extract it, and run WhichSpace.app

Things to know

  • macOS only.
  • Some AppleScript moving-window features require macOS Sonoma or Tahoe 26.4 and later, and are unsupported on Sequoia.
  • macOS allows only one menu bar item per app, so each display cannot show a different Space number.

Topics

#macos#menu-bar#spaces#window-management#applescript#swift#productivity

FAQ

What is WhichSpace?
A macOS menu bar utility that shows the active Space number and lets you switch or move windows between Spaces. WhichSpace sits in the macOS menu bar and displays the number of the Space you are currently on, so you no longer need to guess which desktop you are in. It can show only the active Space or every Space at once, and can include Spaces from all connected displays in a single menu bar item.
Is WhichSpace free to use? What license does it have?
WhichSpace is open source under the MIT license. Check the license terms before using it in commercial products.
Is WhichSpace still maintained?
Actively maintained. The last commit to WhichSpace was on Oct 18, 2026.
What can I use WhichSpace for?
Keeping track of which desktop you are on when using many Spaces Jumping between Spaces quickly from the menu bar or with keyboard shortcuts Labeling Spaces with names like Work or Mail for easier navigation Automating Space switching or window moves from scripts and Shortcuts
How do I install WhichSpace?
Install with Homebrew: brew install --cask whichspace Or download WhichSpace.zip from the releases page, extract it, and run WhichSpace.app
Where can I get WhichSpace?
The source code and installation instructions are on GitHub: https://github.com/gechr/WhichSpace

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects