Skip to content

gechr/WhichSpace

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

393 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

WhichSpace

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

Homebrew (recommended)

brew install --cask whichspace

GitHub

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

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.

Empty Spaces can be hidden entirely.

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'

About

πŸ–₯ Menu bar utility for viewing and switching Spaces (macOS 14.0+)

Resources

License

Stars

725 stars

Watchers

9 watching

Forks

Contributors

Languages