Classic Spy

Can I customize the icons Classic Spy shows in the menu bar?
Yes. Control-click the ClassicSpy.menu package's icon and select Show Package Contents. Go to Contents/Resources directory. There are 4 TIFF icons there:
  • ClassicOff.tiff ? displayed when Classic is not running;
  • ClassicOffAlt.tiff ? 'inverted' icon, displayed when you click the menu while Classic is not running;
  • ClassicOn.tiff ? displayed when Classic is running;
  • ClassicOnAlt.tiff ? 'inverted' icon, displayed when you click the menu while Classic is running.
Open them in an image editing application to see how they are made. When you create your own icons, save them under the above names as TIFF with transparency without any compression. You can do this in Adobe Photoshop 6.0 or later. After installing new icons in the ClassicSpy.menu package log out and back in for the changes to take effect.
I am trying to uninstall Classic Spy, but when I drag its icon off the menu bar, all the icons disappear and then re-appear just as they were. What's going on?
This is an irregularly appearing bug associated with SystemUIServer's undocumented API. If this happens, do the following steps to uninstall Classic Spy:
  1. move ClassicSpy.menu package to the Trash;
  2. log out and back in;
  3. empty Trash.
Can I remove/reload Classic Spy without logging out or restarting?
Yes. You should be logged in as an administrator. If you want to reload Classic Spy rather than uninstall it, omit steps 1 and 3:
  1. Move ClassicSpy.menu package to the Trash.
  2. Launch Terminal.app (located in /Applications/Utilities) and type:
    ps -xc
    Press Enter and look for the line containing SystemUIServer and remember the number in that line under the header PID (usually the left-most number). Then type:
    kill <pid>
    where <pid> is the number you've looked up. Press Enter. All icons in the system menu bar should disappear and re-appear again.
  3. Empty Trash.
What languages does Classic Spy support? Can you add my native language?
Classic Spy supports as many languages as Mac OS X does, including its future versions. Classic Spy 2.1 has a minimal interface of only 4 phrases. If you have Developer Tools, you can add your native language to the package yourself. However, the best way to do it is translate the following and send me your translation via e-mail:
  • Start Classic
  • Stop Classic
  • Open System Preferences
  • Force Classic to Quit
Note that some languages are not currently supported system-wide. For example, I tried making Russian support in Classic Spy on English Mac OS 10.1.5. It did not work. There is a temporary fix until Mac OS 10.2 ships, but it is not for 'normal' users since it involves the modification of system files. Until then only those language packs which are available via Software Update will also work in Classic Spy. If you are a true Mac OS X geek, try it yourself. If you know an easy way without adding empty folders to certain system directories ;-) feel free to drop me a line.
I looked through crash logs: Classic Spy seems to crash SystemUIServer. Is this the case?
It is possible. There is no official documentation on menu extras API and something may well go wrong with Classic Spy. Source code is freely available, so if you find any mistakes, please, send me an e-mail.
Are you planning 'killer' features like access to Control Panels?
I thought about it. However, there are so many features related to Classic that a tiny menu extra may eventually turn into a huge application. That would require too much effort and time; I am afraid I cannot afford it. I want to keep Classic Spy free. Besides, one day Classic will become so rarely used that Classic Spy will not be worth any support.
Where do I install source code for Classic Spy?
You may keep it where you like. Moreover, if you do not want to dig in the code or compile it, you do not even have to copy it. The source code is provided as part of GNU General Public License and intended primarily for programmers. To build Classic Spy yourself you will need Developer Tools.
I cannot compile Classic Spy from the included source code.
You should compile the daemon first. Locate the classicspyd folder inside the source code folder. Open the classicspyd.pbproj project in ProjectBuilder and compile it. Then the ClassicMenuExtra.pbproj project should get compiled without errors.
How to uninstall Classic Spy 1.0?
The following instructions apply only to Classic Spy 1.0. Later versions do not require an (un)installer and can be removed manually by dragging Classic Spy's icon to the Trash.
  1. Download the uninstaller script.
  2. Make sure Classic Spy is not set to launch at login time (open System Preferences, Login, Login Items tab and remove Classic Spy from the list if it is there).
  3. Run the uninstaller script. After it quits, look into /Applications to make sure Classic Spy is deleted.
Is Classic Spy 2.1 compatible with Jaguar (Mac OS 10.2)?
Apple engineers introduced a 'feature' in Jaguar to block third-party menu extras. This made Classic Spy 2.1 incompatible with Jaguar. It means that Classic Spy simply will not load and will not show its icon in the system menu bar. Nothing bad will happen to your system with Classic Spy still installed. There is a way to circumvent the block, though. If you like some third-party menu extras and want them to work anyway, here is a fix. I am not affiliated with Unsanity; please contact them if something goes wrong.
I have installed Classic Spy, but when I click Start Classic, nothing happens and Classic never starts.
There are actually two versions of Classic Spy in the distribution. If you have Mac OS X 10.2.x (a.k.a. Jaguar), open Mac OS 10.2 (Jaguar) and later folder. Classic Spy for older Mac OS X versions is located in Mac OS 10.1.x only folder.
I downloaded version 2.1.2 but it looks like the intructions are for the previous version 2.1.1.
Since no functional changes were made in 2.1.2, documentation was not updated. If the disk image is named Classic Spy 2.1.2, you do not have to worry.
How can I tell what Classic Spy version I am using?
Locate your copy of Classic Spy on your disk. If you followed installation recommendations, open Library folder in your home directory, open Bundles folder inside it, click ClassicSpy.menu and press Command-i.