How to install AUI

This is going on an Intel Mac running Leopard, right? Otherwise it's not going to work.

That's about all there is to the basic install. The tarball contains the program and all the files and folders necessary to run it.

The program itself is in user aui's "bin" folder (short for "binary" — more unixSpeak), not the standard OS X Applications folder. It's put there because it should always be run by user "aui", and nobody else can run it from that folder.

You can drag its icon from the "bin" folder to aui's dock — it will launch just fine from there.

This basic installation process will create sample user folders for AUI users named Alan Turing and Ada Lovelace. Their passwords are "1066" (AUI passwords are numbers, and they're stored unencrypted — AUI user names and passwords are mostly just to keep users' documents and settings separated, not to maintain privacy or security).

In addition to the basic install, you probably should also download the "soundClips.tar" file from the downloads folder and untar that in aui's home folder as well — you'll get a new folder, called "soundClips".

It's a collection of sound effects made available by one of the activities (Recordings) in AUI's Activities menu. It's completely optional and doesn't need to be there. If it isn't, some parts of the Recordings activity won't work, that's all.

New Users

There is no civilized way to create AUI users — almost, but it doesn't quite work yet.

The uncivilized way is to create a folder for a new user in the home folder (the name of the folder is the user's first and last names concatenated and lowercased), option-drag another user's userSystemPrefs file to the folder, and modify it with a text editor for the new user's name, password, and home directory — the other settings can be personalized by the Preferences activity after login.

Creating a new user this way probably won't work unless you know a little XML, but you won't break anything if you try. The worst thing that can happen is that you'll have to untar that distribution tarball again. But if you try and are successful, you now know a little XML.

On the other hand, it won't hurt a thing to just log in as Alan Turing or Ada Lovelace. Everything will work just fine — the Narrator'll call you Ada or Alan from time to time, that's all.

Optional, but a good idea

To make things easier for B/VI users, set aui the user to be logged in automatically at startup (OS X System Preferences -> Accounts -> Login Options), and set AUI the program to run automatically when aui is logged in (same place, but look at Startup Items instead of Login Options). Make sure none of the other startup programs (if any) do anything visual so the Mac won't be sitting there waiting for somebody to click OK.

This will get the computer up and running in aural mode without having to do anything at all with the GUI. You'll hear the Mac chime as it starts up, and after a little bit, you'll hear the thonk AUI makes when it starts up, some 'space filler' sounds, then the "Logging in. What's your name?" prompt of the Login activity.