Platform Independent Installation

The platform independent distribution of Harmonium should run on any system that has an installed Java Runtime Environment. This distribution is especially well suited for testing out Harmonium, or for configuations that aren't supported by other distributions.

TiVo Requirements

  • A network enabled Series 2, Series 3, or HD TiVo.
    Note
    Configuring your TiVo to connect to your network is beyond the scope of these instructions. For help see the TiVo website.
  • The TiVo must be enabled for Home Network Applications. To do this, perform the following:
    1. From TiVo Central, go to Music, Photos, & More.
    2. Select Enable Home Network Applications...
    3. Press THUMBS UP three times, then press ENTER to enable local HME applications.
    4. Return to TiVo Central, then Music, Photos, & More. The option should now appear as Disable Home Network Applications...

Server Requirements

  • No specific operating system required
  • Java runtime evironment version 5 or later.
    Tested
    • Sun Microsystems Java SE Runtime Environment, version 6, update 6
    • Sun Microsystems Java 2 Runtime Environment, Standard Edition, version 5, update 15
  • Connected to same network as TiVo.
    Note
    The server's networking subsystem must be initialized before starting Harmonium. In particular, the server's network interface must have an IP address assigned before Harmonium is started. This might be an issue if your computer is connected to a wireless network and doesn't receive an IP address until late in the boot process, or after a user logs in.

Installation Instructions

    Pre-Installation

  1. Identify the path to the music root directory. All music files must be in the music root or one of its subdirectories.
    Note
    In our example below, we assume that the music root is: /home/music
  2. Identify the path to the playlist root directory. All playlist files must be in the playlist root or one of its subdirectories.
    Note
    In our example below, we assume that the playlist root is: /home/playlists
  3. Ensure that the java executable appears in your execution path.

    4. Installation

  4. Uncompress the installation archive to your chosen installation directory.
    Example
    $ tar zxvf harmonium.tar.gz
  5. Change your working directory to the installation directory for Harmonium.
    Example
    $ cd /foo/bar/Harmonium
  6. Execute Harmonium using correct syntax. Use the example below and substitute the music root and playlist root you identified above.
    Example
    $ java -jar Harmonium.jar org.dazeend.harmonium.Harmonium -musicRoot /home/music -playlistRoot /home/playlists
    Note
    When Harmonium first starts, it reads and catalogs the music files that it finds under your music root. This process may take several minutes. (A sample collection of 3500 music files takes 20 minutes to complete.) Until this process has completed, Harmonium will not appear on your TiVo.
    Note
    As a convenience, a shell script called run.sh is included that can be edited and used to start Harmonium on Unix-like systems.