WhichSpace

April 13, 2026 · View on GitHub

Have you ever forgotten which space is currently active on macOS and wanted a quick way to tell? Didn't think so... but I did!

Overview

  • Multiple Spaces - Show current Space only, or all Spaces at once
  • Multiple Displays - Show Spaces across multiple monitors
  • Click-to-Switch - Jump to any Space directly from the menu bar
  • Colors - Set foreground and background colors per Space
  • Icons - Choose from multiple icon styles (square, circle, triangle, and more)
  • Labels - Replace Space numbers with custom text labels
  • Symbols - Use native macOS symbols instead of numbers
  • Emojis - Use emojis to get even more creative
  • Badges - Add a small character of your choice next to the Space number
  • Size - Scale icons to your preference
  • Sound - Play a sound when switching Spaces
  • AppleScript - Automate with scripting support
  • Launch at Login - Start automatically with macOS
  • Auto-Updates - Stay up-to-date with automatic updates
  • Languages - Translated into multiple languages

Installation

brew install --cask gechr/tap/whichspace

Important

If you previously installed via brew install --cask whichspace, uninstall it first with brew uninstall --cask whichspace

GitHub

  • Download WhichSpace.zip
  • Extract WhichSpace.zip and run WhichSpace.app
  • Future updates will be handled automatically

Important

Since WhichSpace.app is not notarized, macOS may show a warning along the lines of:

Apple could not verify "WhichSpace.app" is free of malware that may harm your Mac or compromise your privacy.

To bypass this, run the following command in Terminal:

xattr -r -d com.apple.quarantine /path/to/WhichSpace.app

Or right-click the app and select "Open" to add an exception.

Features

Spaces

Show the current Space only, or choose to show all Spaces

Click on a Space to switch to it

Note

Inactive Spaces are dimmed by default.

Displays

Show the current Display only, or choose to show all Displays

Note

A vertical separator is shown between Displays.

Full-screen apps are shown as F and can be hidden entirely.

Colors

Choose foreground and background colors for each Space, or apply one color to all Spaces

Icons

Choose from a variety of icons for each Space, or apply one icon to all Spaces

Symbols

Use custom symbols instead of numbers for a more personalised look

Badges

Add a small character next to the Space number

Note

Use # as the badge character to insert the current Space number.

Labels

Replace Space numbers with custom text labels

Note

Use {number} in a label to insert the current Space number, e.g. {number} - Work → 3 - Work.

Size

Adjust the scale and padding of the icons in the menu bar

Sounds

Play a sound when switching Spaces

Choose from built-in macOS system sounds, or add your own custom sounds.

To add a custom sound:

  1. Create the ~/Library/Sounds directory (if it doesn't already exist)
  2. Copy your sound file into the directory
  3. The sound will appear under the User section in the Sound menu

Scripting

Use AppleScript for automation

# Get the current space number (1-based numeric index)
osascript -e 'tell application "WhichSpace" to get current space number'

# Get the current space label (as shown in the menu bar, e.g. "1", "2", "F" for fullscreen)
osascript -e 'tell application "WhichSpace" to get current space label'

# Switch to a specific space on the current display
osascript -e 'tell application "WhichSpace" to switch to space number 3'