Eyeballs User Manual
Last modified January 28, 2004.
By Ben Haller. Copyright © 2004 Stick Software.

[ This manual is only available in English at present. ]Eyeballs is a Mac OS X application that gives you a fun set of eyeballs in your menu bar or on your desktop. Thismanual assumes that you have already downloaded a copy of Eyeballs; if not, visit Eyeballs' web page at http://www.sticksoftware.com/software/Eyeballs.html. It also assumes that you know all the basics of using theMacintosh in Mac OS X, including using the mouse, menus, and windows, and opening and saving files.
Right now this "manual" is really an FAQ (frequently asked questions) list, because Eyeballs is a simple enoughapp that it doesn't seem to merit a full manual — that would just be a lot of work and would probably be lesseffective at answering actual user questions. Let us know if you disagree, however; if a full manual is needed forEyeballs, it can be made.
Please send comments on this manual to us at bhaller@sticksoftware.com. Thanks!

Questions
What is Eyeballs and what does it do, in a nutshell?
How and where do I install Eyeballs?
What do all these controls do?
OK, but how do I *use* the darn thing?
How do I share my Eyeballs personalities with friends?
What about skins?
What is shareware? How do I pay?

What is Eyeballs and what does it do, in a nutshell?
Eyeballs is a "desktop critter" for Mac OS X. It provides you with a set of eyes on your desktop or in your menubar, for your entertainment and amusement. For example, here's a very simple set of eyes:

The appearance and behavior of the eyes are extremely configurable, so you should be able to create whatever eyes
your heart desires. For more information on the basic concept of Eyeballs, and many more images of possible
eyes, please check out its home page at http://www.sticksoftware.com/software/Eyeballs.html, which covers thispretty well.

How and where do I install Eyeballs?
Eyeballs is a breeze to install. Simply copy the Eyeballs application into one of the standard OS X locations forapplications, such as /Applications or ~/Applications (where "~" is short for the location of your home directory).
No further setup is required. Once you've got Eyeballs copied to a standard location, just double-click it in theFinder to launch it.
Which folder should you use? ~/Applications is the typical location used if you do not have Administrator
privileges on your OS X machine, or wish Eyeballs to be available only to you, not to other users of the machine. /Applications will make Eyeballs available to all users of the machine, but typically requires Administrator
privileges for you to copy things into it. For more information on this, see Apple's documentation on using OS X;~/Applications is the safer choice, however, if you are not sure.
Drag Eyeballs from the disk image it is distributed on, into the folder where you wish to install it. After it has been
copied, you may 'eject' and throw away the distribution disk image. If you are unfamiliar with the use of disk
images (.dmg files), you can read more about disk images on Stick Software's web site at http://
www.sticksoftware.com/register/diskimages.html.
If you want Eyeballs to run automatically whenever you log in, add it to your Login Items in System Preferences.
For more information, read more about login items on Stick Software's web site at http://www.sticksoftware.com/register/loginitems.html.
To uninstall Eyeballs, simply drag Eyeballs from your hard drive to the trash. You will need to quit Eyeballs
before you will be able to empty your trash.

What do all these controls do?
There are lots of controls to explain, but we're not going to spend a lot of time here explaining them. Part of the
fun of Eyeballs is experimenting and discovering the program. If you want hints on what different controls do,most of them have tooltips. Eyeballs is quite bulletproof — you will not hurt anything by experimenting. (Notethat is not intended to be a legally binding guarantee... ah, to live in less litigious times... we make no warranty as
to Eyeballs' lack of bugs, suitability for any purpose, etc., and you assume all risks in using it...) Despite thenecessity of the legal disclaimer, you really can just play around and explore the app. You really don't needdocumentation on each slider... trust us.

OK, but how do I *use* the darn thing?
Ah. Well. Eyeballs doesn't have a Dock icon, so it is somewhat unconventional in the way you interact with it.
When you first start out, you should see a little notice about this; that notice may be taken less than completely
seriously by most people, though, and then you're left with little eyeballs running about that you seem to have nocontrol over whatsoever. (Many parallels to human reproduction here, one might note...)The key to using Eyeballs is the context menu. This is a little pop-up menu that you can get in a few different
ways. One way is to hold down <control>, and click on the eyes. Another way is to double-click on Eyeballs' iconin the Finder; Eyeballs is already running, but this tells Eyeballs you want to interact with it, and so it presents its
pop-up menu. A third way, available only if you have a two-button mouse, is to right-click on the eyes, rather thancontrol-clicking on them.
The context menu has a Quit item that lets you stop running Eyeballs. It also has items that let you bring up
various web pages and documentation, one that opens Eyeballs' preferences panel, and one that lets you register orderegister Eyeballs. Once you get the context menu up, the rest is pretty self-explanatory.
For more information on how to control "desktop critters" such as Eyeballs, read about desktop critters on Stick
Software's web site at http://www.sticksoftware.com/register/critters.html.

How do I share my Eyeballs personalities with friends?
Starting with version 2.1 of Eyeballs, all of your named custom personalities are saved to files inside the folder ~/Library/Eyeballs (where "~" is your home directory). The files will have the same name as the personality nameyou chose in Eyeballs, with the extension ".plist" added. The extension may not be visible, depending upon yourFinder settings.
These personality files are entirely portable; you can e-mail them, post them on the web, or anything else you'dlike. Other users can install personality files by simply copying them into their own ~/Library/Eyeballs folder. The
next time that they open Eyeballs' Preferences panel, the new personalities should be listed in the personality popup button.
The built-in personalities are not saved to files in this way, and a custom personality is not saved until you give it aname. If ~/Library/Eyeballs does not seem to exist, and you have run Eyeballs 2.1 at least once, then a permissions
problem is probably preventing Eyeballs from creating the folder. Fix the permissions of the ~/Library folder in
the Finder and run Eyeballs again. If ~/Library/Eyeballs exists, but it is empty and named custom personalities
don't seem to get written out to files, it is (again) probably a permissions problem; try removing the ~/Library/Eyeballs folder and allowing Eyeballs to re-create it.

What about skins?
Eyeballs supports "skins" as well as personalities. Skins are installed in ~/Library/Eyeballs just like personality
files; they appear in the Finder as folders with a path extension of "eyeskin", like "Googly.eyeskin". Some skins
are built into Eyeballs; more can be downloaded from the web (Eyeballs' home page, at http://www.sticksoftware.com/software/Eyeballs.html, will link to sites that have eyeskins).
Making your own skins is possible but complicated; it is not for the faint of heart or the novice user. If you want
to try your hand at it, however, we have a separate manual about making your own skins at http://www.sticksoftware.com/software/ebskins/SkinsManual.html.

What is shareware? How do I pay?
As a closing note, we'd like to remind our readers that Eyeballs is a shareware product. It is required that you pay
the shareware fee if you use Eyeballs beyond a trial usage. Eyeballs costs $10.
Information on how to pay and other registration details can be found at http://www.sticksoftware.com/register.html, or you can simply pay with a credit card (or other methods) with no further ado at https://order.kagi.com/?6ZD.
Comments on Eyeballs, suggestions for future products, and other feedback are welcomed at
support@sticksoftware.com. Thanks for your support!