Installation Archives

These installation archives contain everything that is needed to install Harmonium on different platforms. Choose the distribution that best fits your needs and hardware configuration. For more help on deciding which distribution is right for you, read the installation instructions next to each file.

Version 0.5.1 Beta Installation Archive Instructions
Platform Independent tar.gz zip Install Upgrade Uninstall
Windows Service -- zip Install Upgrade Uninstall
Linux Daemon tar.gz -- Install Upgrade Uninstall

Older versions of Harmonium are available in the Archives.

Change Log

Version 0.5.1 BETA (10 Sep 2008)

  • Reverted to version 1.4 of HME SDK because of several bugs encountered in version 1.4.1 (album art failed to load, Factory hung on server). This change required that the Bananas library be reverted to version 1.3, and that the use of Bananas-Plus be discontinued (it depends on HME SDK 1.4.1e and Bananas 1.3.1e) in favor of HME-HD.

Version 0.5 BETA (30 Aug 2008)

  • Upgrade components to HME 1.4.1e, and BananasPlus. This improves the visual style of standard definition, and adds some advanced components.
  • Remove splash screen.
  • Fix bug affecting simulator. Reported here.
  • Extend album info elements on Now Playing Screen to allow for longer strings.
  • Remove interstitial screens when browsing. Make SELECT and RIGHT do the same thing, namely browse.
  • From browse screens, make ENTER key add to playlist. Add note below list to prompt user.
  • Have Screen Saver ignore VOLUME_UP, VOLUME_DOWN, and MUTE key presses.
  • Have Screen Saver pop when playlist ends, so that leaving screen saver can't take you to Now Playing Screen when no music is playing.
  • In browse screens, jump by letter using ADVANCE/REPLAY keys.
  • Have SELECT from Edit Playlist screen take user to a Track Info Screen with album art and track details. (This will make sure that user knows what track is highlighted even when title is cut off in list.)
  • Fix ScreenSaverScreen so that it is all black, even when letterboxing is set to gray.

Version 0.4.3 BETA (11 Aug 2008)

  • Correct class path in MANIFEST.MF, so that platform independent installation would start correctly.
  • Replaced background MPEGs with versions that meet TiVo specifications. (Fixes flickering background problem on some televisions.)

Version 0.4.2 BETA (10 Aug 2008)

  • Prevent music collection from being erroneously flagged as out of date immediately after being built. (Re-set cache timestamp when writing cache.)
  • Catch errors and exceptions in Factory init.

Version 0.4.1 BETA (09 Aug 2008)

  • Limited release
  • Add debugging messages

Version 0.4 BETA (07 Aug 2008)

  • Check if file exists on disk before playing it.
  • Put version on splash screen.
  • Permitted non-standard MIME type of "image/jpg" for album art. (This is a workaround for broken ID3 taggers.)
  • Cache the music collection for faster start up.

Version 0.3.1 BETA (29 Jul 2008)

  • Bug Fix: Fixed backgrounds of Now Playing Screen. Displayed wrong images for different formats under simulator/TiVo.

Version 0.3 BETA (29 Jul 2008)

  • Bug Fix: Allow empty HPL playlists to be loaded into the music collection.
  • Cosmetic: Play bonk sound on playing empty playlist.
  • Cosmetic: Put version string on About screen.
  • New Feature: Compile for Java 5.0.
  • Bug Fix: Ignore invalid ID3 header frames.
  • Bug Fix: Strip whitespace from tags to avoid duplicates entries.
  • Bug Fix: Have MP3's ignore disc tags that are equal to "1/1" so that no disc object is created for the track.
  • Bug Fix: Fix album info spacing on NowPlayingScreen on 480i screens so it is legible.
  • Bug Fix: Rename up_down_*.png to names that match backgrounds.
  • Bug Fix: Prevent end of playlist from doing a pop() screen if not on NowPlayingScreen.
  • New Feature: Refresh music collection on app start. Newly added tracks and playlists should appear in music collection without restarting the server (Factory). Similarly, deleted tracks and playlists should be removed from the music collection.
  • New Feature: Display splash screen on app start until music collection has been refreshed. (So that user doesn't stare at blank screen for several seconds.)
  • Bug Fix: Make screen blanking work when Now Playing Screen is showing.
  • New Feature: Make PLAY button work for "Play Entire Music Collection" on main menu.
  • Cosmetic: Added warning that searching for music may take several minutes at startup.
  • Cosmetic: Updated look of the Now Playing Screen.

Version 0.2 BETA (25 Jul 2008)

  • Bug Fix: Now properly handles empty playlists.
  • New Feature: Pause button now pauses/unpauses music from all screens.
  • New Feature: Info button now jumps to Now Playing screen from all screens if music is playing.
  • New Feature: Clear button now blanks screen from Now Playing Screen.

Version 0.1 BETA (18 Jul 2008)

  • Initial release.

Source Code

Source archives contain the source code that is needed to build Harmonium. Most people will not need a source archive, but they are made available so that others can modify and improve the program. For your convenience, source archives are available in two different formats.

Version tar.gz zip
v0.5.1 Beta download download

Older versions of Harmonium are available in the Archives.

Additional Libraries

Harmonium relies on several other open source components. In compliance with the various open source licenses these libraries use, I offer them for download here. The only reason that you would need these is if you were going to try to compile the Harmonium source code. The libraries needed to build the latest version of Harmonium are listed below, libraries needed for older versions of Harmonium are available in the Archives. Most people won't need these, but it's available to those who do.

Library Version Binary Source
TiVo HME SDK 1.4.0 download (included in binary)
TiVo Bananas UI Toolkit 1.3.0 download (included in binary)
TiVo HME-HD Library 0.1.1 download download
Apache Commons Logging 1.1.1 download download
OpenCSV 1.8 download (included in binary)