GPL License

 Hosted By

What is Tuneology?

Tuneology is a Java Swing program for managing audio and video files, and playlists. Tuneology provides Browsers for the places where your music is stored.

You can transfer files between Browsers using copy and paste, or drag and drop. You can copy an entire album, consisting of all its tracks and also the playlist, in a single operation. You can delete files and albums, when possible.

You can also play music and video files, and adjust the volume level on your sound card's mixer.

For example, you can copy files from your MP3 collection onto a CD-RW disc, either as an Audio CD or as a data disc containing MP3 or OGG files. You can copy the contents of your Audio CDs into MP3, OGG, or whatever format you choose. Don't worry about converting between formats, Tuneology takes care of it for you.

Tuneology works hard to collect and preserve meta-data (song titles, artist names, etc.).

Tuneology can keep track of meta-data in an SQL database. You can edit the meta-data in the database, and view the edited information, even if you do not have write access to the actual music files. You can also maintain meta-data for files that normally do not contain such information, such as WAV files and AIFF files.

Tuneology can be operated via Infrared Remote Control.

Hopefully soon you will be able to print labels for the CDs you create with Tuneology, and copy files into and out of portable music players.


  • Runs on Mac OSX, Linux (Intel only) and Windows.
  • Java Media Framework (JMF) is not required.
  • Platform-specific functionality via JNI and external programs.
  • Easy installation with the IzPack installer.
  • Supported file formats: WAV, AIFF, MP3, OGG, FLAC, AAC, AU.
  • Auto-detection of OSS or ALSA drivers on Linux.
  • Fully multithreaded - supports multiple simultaneous actions, limited only by hardware.
  • Reads Audio CDs, including CD-Extra and CD-TEXT data, using cdparanoia or cdda2wav on Linux, akrip or cdda2wav on Windows, and built-in ripping capabilities on OSX.
  • Looks up Audio CD info from freedb.org
  • Plays Audio CDs, adjust sound volume of drive or mixer input.
  • Plays music and video files, with sound volume adjustment.
  • Reads playlist files with references to local files.
  • Create new playlists.
  • Create Audio CDs with CD-Extra and CD-TEXT data.
  • Create ISO9660 data CDs with audio, video and playlists.
  • Can be run via Infrared Remote Control on systems with LIRC installed.
  • Mount ISO file images on Linux using the loopback device.
  • Look & Feel is user-selectable; Kunststoff is included.
  • Caches file information in SQL database for faster access.
  • Backup and restore file information from SQL database to XML file.
  • Automatic audio file format conversion as necessary.
  • Uses jd3Lib, nanoxml, java-avm and java-irremote.
  • Coming Soon: Print labels and case panels for created CDs. Upload, download, list files, etc. from portable music players. Skin Look & Feel.
  • Browsers

  • Local File System
  • Audio CD
  • ISO9660 CD
  • Loopback Filesystem Image
  • create ISO9660 CD
  • create Audio CD
  • Coming soon:

  • Diamond Rio 600
  • Minimum Requirements

    Optional on all platforms:

  • An SQL database, and its JDBC driver. PostgreSQL and MySQL are currently supported. Others are planned. Tuneology runs well without an SQL database, but its functionality is somewhat limited.
  • faad2, for decoding AAC files.
  • xmms (yes, it runs on OSX and Windows!).
  • Mac OSX

  • Mac OSX 10.2.4 or later.
  • QuickTime.
  • Nothing else is needed! Java 1.3.1, installed by default, is used. Drag And Drop does not work with 1.3.1 (IMHO), but copy and paste works fine. Java 1.4 is not used because it does not support QuickTime.


  • LIRC
  • Windows

  • Windows 95 SP1, 98, ME, NT, 2000, or XP.
  • Java 1.4.1 or newer (older versions are buggy; especially bug IDs 1245049, 4109888, etc.).
  • An ASPI library is required. Also see this page for further information.
  • Optional:

  • Winamp 3, with the Winamp 2x Plugin Manager; or Winamp 2. You may also want to install the AAC plugin.
  • Linux

  • Any Intel Linux distribution capable of running Java.
  • Java 1.3.1 or newer. 1.4.1 is much faster and is highly recommended.
  • There are many linux kernels and glibc versions, so it is not possible to include the executable programs required. Most distributions already include these programs, so you shouldn't have a problem.

  • cdrtools-2.0. cdrtools is a part of most Linux distributions, but the installed version may be too old.
  • cdrdao, an alternative CD burning program.
  • madplay, an MP3 player and file converter.
  • lame, an MP3 encoder.
  • FLAC encoding and decoding software.
  • vorbis-tools, for encoding and decoding Ogg Vorbis files.
  • cdparanoia.
  • Each ATAPI (IDE) CD drive must be remapped as a SCSI device by adding the following boot option:


    The instructions for this should be included with your distribution. If not, it is explained in the CD-Writing HOWTO. You should also read this page.
  • It is highly recommended to install and configure sudo so that specific users can get necessary access to desktop hardware. In particular, cdrecord, cdrdao, mkisofs, cdda2wav, readcd, and losetup require root access. sudo is part of most Linux distributions. Currently you must configure sudo so that it does not prompt for a password when the required programs are run.
  • Optional:

  • xanim
  • MPlayer
  • LIRC
  • Installation


    Download Tuneology-install.jar and double-click on it. The installer checks to see that ASPI is installed, and that the registry is set properly. If not, the installer provides a button that you can press, which will modify the registry so that the cd burning software will work correctly.

    If the installer modifies the registry, you have to reboot before you can run Tuneology, although the installer doesn't say so. Otherwise the IDE drives will not be visible to Tuneology.

    Mac OSX

    Download Tuneology-install.jar and double-click on it. After exiting the installer, but before running Tuneology for the first time, open a terminal window and type the following:

    cd /Applications/Tuneology/Tuneology.app/Contents/
    sudo sh ./osx-install.sh


    Download Tuneology-install.jar. Type:

    export JAVA_HOME=where's your java
    $JAVA_HOME/bin/java -jar Tuneology-install.jar


    This project is hosted at Sourceforge. Check out the project page and the download page.


    Current plans:

    Release 0.1 - This will be the first release, real soon now! Prereleases are available from the download page. There are bugs, and some features are not implemented on some platforms.

    Future - Add more CODEC options, more media players, support more databases, support for sox, QuickTime support for Java 1.4 (as soon as Apple releases it), libogg support, MP3 and Minidisc players, Quicktime 4 Linux, rscsi, i18n, virtual tree view for faster initialization with large directories. Releases for BSD, Solaris, and other Linux implementations are possible.


    Fran Taylor