Setup instructions for compiling and running Bookie:

If you're just browsing or don't need to edit files directly, you can look at Bookie through the web interface.

If you want to contribute to Bookie or compile it, then you should grab a CVS client and set up a workspace for bookie.

You download bookie by doing this (you only need to login once, the password is guest). Please use the prune option when checking out and updating, since the CVS tree has a lot of dead branches in it.

cvs -d login
cvs -d co bookie -dP

The java client is in /clients/swing. There is an ant script that should compile everything.  The client's main class is com.tersesystems.bookie.client.Client.

The java server is in /server. Again, the ant script that should compile everything. The server's main class is com.tersesystems.bookie.service.xmlrpc.BookieServlet.

The server will create four files on initialization in the current directory:

These databases contain all the information needed for the server to work. Deleting these files will cause the server to start off fresh.

Bookmarks are cached on the server, but since bookmarks are unique to each client this isn't that much of a win. Performance seems okay for now (and if anything seems bound on the XML processing and IO overhead). Database operations are not transactional.

Please e-mail me at if you have any problems.