Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Simple Carbon utility to get or set the current Spaces workspace ID.
C
branch: master

This branch is 15 commits behind shabble:master

Failed to load latest commit information.
CGSPrivate.h
Makefile initial commit from local stuff
README.md Updated readme
main.c Added ability to switch spaces (without animation, unfortunately)

README.md

OSX Spaces Current Workspace

[Original code is from shabble, with some updates from canadaduane]

For a variety of useful and useless purposes when scripting in OSX, it might be handy to know which of the Spaces (virtual desktops) you're currently on. You may also wish to programmatically switch spaces from the command line.

To the best of my knowledge, the necessary ID is not programatically accessible without jumping through a few hoops.

Meeu Labs has some interesting information regarding hacking undocumented Mac OS X APIs. This command-line tool currently uses CGSPrivate.h to switch spaces. It suffers from two signficant drawbacks, however:

  1. there is no transition animation
  2. focus remains on the window before the switch

Mac OSX Hints has one possible solution, which uses the Assistive Devices support to rip the value from the menubar icon, but this is really horribly hacky, and pretty slow, at least for me. It takes at least a second, and more like 2 or 3 typically.

An alternative idea is presented on StackOverflow which uses some of the (probably horribly deprecated) Carbon APIs fetch a window handle, and then poke around in its internal dictionary to find the workspace ID.

The latter is the method implemented here.

Usage

Compile with:

$ make

and run with:

$ ./spacefinder

The program should terminate immediately, printing a string to STDOUT which matches the regex /^Current Space ID: \d+$/. The current space number is also the return code of the program for ease of use in scripting apps. If the space cannot be identified for whatever reason, it will be returned as 0.

If you call spacefinder with the -q option, it will enter quiet mode and only print the space number (matching /^\d+$/)

I have no idea what happens if Spaces are disabled, or if you manage to invoke it from the Spaces Expose screen, or other weird edge cases. Submissions welcomed.

I have no idea if this will behave correctly on Snow Leopard, I'm still running 10.5.8

Something went wrong with that request. Please try again.