Quick Start

Tomes allows you to download many free titles directly over the Internet, but best of all (we think!), you can load your own e-books from your computer using the free ShelfServer application.

ShelfServer is written in Java so that it can run on Windows, Mac OS X, Linux, or most anything else where a JRE is available. In order to run ShelfServer, you must have a Java version 1.5 JRE (or newer) installed. On Windows, the installer will automatically download and install a JRE from Sun if none is available. For Mac OS X, Apple ships a suitable JRE on all versions from Panther on up. For Linux, well... Sorry... You're on your own there. ;-)

Download Here

Mac OS X logo
Mac OS X
Windows logo
Windows
Linux Penguin Logo
Linux & Others

Note that "Net" installs require an active Internet connection to complete the install process. "Full" installs will work without any additional download. Both Net & Full installs will automatically download updates when they become available.


Advanced Users

While the majority of users should pick one of the packages above, advanced users may find one of the following alternative packages useful.

ShelfServer is also available as a WAR package suitable for deployment in Java application servers such as Apache Tomcat.

ShelfServer's source code is available under the GPLv3 license.


What's a ShelfServer

It's where you keep your electronic books, of course!

While iTunes provides a nice all-in-one interface for syncing contacts and music and such, unfortunately Apple hasn't provided access to the sync framework for iPhone applications. ShelfServer gives you a way to load books onto your device over a WiFi network.

Tomes uses Apple's Bonjour (ZeroConf) networking technology to locate any ShelfServers on the local network. For most users who have WiFi for their iThing attached to the same network as their desktop, this means that Tomes will "just find" any ShelfServers in the area. If your network is split up so that WiFi and wired are on different segments, a bit of advanced ShelfServer configuration will get you reading in no time.

How's it work?

ShelfServer is a Java application and should run on Mac OS X, Linux, and Windows with a minimum of difficulty. ShelfServer uses Apple's Bonjour / ZeroConf API's which may need to be installed separately.

Once ShelfServer is running, you're able to add one or more directories which contain book content. All of these shared directories and any sub-directories underneath them will be available to Tomes on your iThing. You can choose to download files one at a time or recursively download entire directories in one go (space permitting).

Installing Bonjour

Mac OS X

For Mac OS X, everything is ready out of the box.

Windows

For Windows, the necessary libraries are usually installed as part of iTunes, but the Java portion of the libraries doesn't always get installed automatically. If you see something about an "InvocationTargetException" when you try to start ShelfServer, you need to install (or re-install) Bonjour for Windows.

If Bonjour was installed before the Java JDK on your machine or if you're using a JRE instead of a JDK, you may need to reinstall Bonjour. First, download the latest Java JDK (Click the "Get the JDK download" link near the top of the page, the follow the prompts, accept the license, etc.) Any version of 1.5 or newer should work, but get the 1.6 version unless you have a specific reason not to. See Installing the JDK on Windows for specific instructions.

Once the JDK is installed, Apple's documention suggests that doing a "repair" install of Bonjour should install the necessary libraries. So far, this hasn't seemed to work for many users. To fully reinstall Bonjour, go to the Windows Control Panel, choose Bonjour and click Remove. Once the uninstaller completes, download Bonjour from the Bonjour for Windows site and run it.

Here's a direct download link for Bonjour for 32-bit Windows (2.1 MB). If this link expires, try the one above for the Bonjour for Windows website.

Linux

For Linux... Well... Apple says it should work. I haven't tested it yet and would appreciate any reports of success or failure. There's a mailing list post with instructions for Linux.

Start Here:
Quick Start Help

Start Shelf Server


New in Tomes 2.0:
Download Books without using ShelfServer


iTunes iconClick to Install Tomes with iTunes or AppStore


Latest News


[All News]

Generated from site version 3508:3523 on 2012-Jul-20 22:07:11-0400.