Sylvain Gaudard
Alex Aranda
This document describes how to install aTunes on a Linux-Gnome system.
For any suggestions or comments please write to
atunes-documentation(AT)lists(DOT)sourceforge(DOT)net
This document is distributed under Creative Commons License 2.5: Attribution - Non commercial – Share alike.
For more information see http://creativecommons.org/
In order to run aTunes you need to have the following software installed:
Java 6 Runtime Edition (JRE)
mplayer
To be able to import audio CD's you also need [optional]:
cdda2wav or icedax
At least one the following encoders (since aTunes 1.7.3):
oggenc (vorbis-tools) [optional]
lame [optional]
flac [optional]
Note: For versions prior to 1.7.3 all of the following must be installed - oggenc, lame and cdda2wav are necessary to import Audio CD's to mp3 or ogg format. If you don't use this feature, only Java 6 and mplayer are required.
You can use your favourite package manager to install this programs and their dependencies. It is likely some of these are located in a different repository for legal reasons. Please see your distributions documentation to see how to add additional repositories. If Java is not avaible you can get it from Sun Microsystems directly: http://java.sun.com/javase/downloads/index.jsp
Note: It's not required to uninstall older versions of Java Runtime Edition (JRE), but be sure that typing
java -version
on a console you view version 1.6.0 or higher. Alternatively, you can change execution script to point to a Java 6 Virtual Machine (See next sections).
Now let's go to the aTunes download page http://www.atunes.org/?page_id=6. Here you have two options:
Multiplatform Installer. A Java-based installer.
Multiplatform Package (No Installer). A tar.gz file.
Select one file and save it to disk.
If you download Multiplatfom Installer, execute it by double-click, or by typing
java -jar aTunes_Installer_x.xx.jar
on a console, and follow steps.
If you download Multiplatform Package, extract it to wherever you want aTunes be installed.
Note: In this example we assume you want the files installed to /home/user (you probably want to replace "user" with your actual username). You might need root privileges to install to certain locations.
This step is required if "java" command executes a JRE version older than 1.6.0. If this is not your case, skip this section.
In order to run aTunes you must edit the file atunes.sh located in the folder you just created by installing / uncompressing the file. Open atunes.sh with your favourite text editor and look for the line
java -cp ...
This line must be edited to point wherever Java 6 Runtime Edition (JRE) has been installed. If your package manager did it for you it is likely in /usr/bin. So let's assume it is in /usr/bin. Change the line to read:
Save the file and close the text editor.
Please be sure aTunes.sh is executable. For this right click the file aTunes.sh and select Properties.
You can now start aTunes by typing in a console:
/home/user/atunes/aTunes.sh
Now we are going to create a desktop shortcut. Get rid of all the windows you have open and right click on the desktop and select "Create Launcher"
Note: Please don't forget that we assume here that you have installed aTunes to /home/user. So change accordingly.
There you type in the following:
For step three the following window will appear:
