From aTunes Wiki

Jump to: navigation, search

This page contains common questions asked about aTunes. If you don’t find the question that you are looking for, have a look at the Known Bugs section and try the forums.

This page will grow up with common users questions. Please be patient.


General Questions

What's aTunes?

aTunes is a full-featured audio player and organizer. It currently plays several popular audio formats, as well as allowing users to easily edit tags, and organize their music collection. Additionally users can play online radio stations, podcasts and rip songs from their audio CDs.

Which operating systems are supported?

aTunes runs on any platform with a Java 6 compatible Runtime Enviroment. This includes Windows, Mac OS, Linux and Sun Solaris.

What audio formats are supported?

Many popular formats, such as mp3. To see the full list of supported audio formats visit Features

Is it possible to synchronize my iPod with aTunes?

Currently aTunes can only READ iPod contents until 4th generation. It has not been tested with later versions. It can't write songs to iPod. However, aTunes can write to many generic mp3 players acting as external hard drive (i.e. mass storage devices).


Where can I get aTunes from?

First of all you will find a Windows and a multi-platform installer as well as a Debian/Ubuntu package at our own website.

For Mandriva, Puppy and Suse Linux users rpm packages are ready.

For the less shy, there is also a unstable release available.

Where do I get Java from?

You can download the latest Java version at http://www.java.com/download/

Many Linux distribution are providing a Java 6 package (sun-java6-jre or sun-java6-jdk for Debian/Ubuntu) in their respective package manager. If you install from such a package manager, make sure Java 6 is really used as default by typing java -version in a console. If it does not say Java 6 and you are using Ubuntu, you might try: sudo update-alternatives --config java and select the appropriate Java version.

Some Linux distributions are also beginning to ship the open source OpenJDK/Icedtea. While latest versions are reported to work, it is to be noted that these still tend to be buggy and currently offer inferior performance.

Apple finally provides an official update for OS X 10.5 Update 1 (64bit Intel systems only). More information can be found on the Apple Support page. Keep in mind that this update will not set Java 6 as the default JRE, it will need to be done manually. Unluckily, there is no official Java 6 release for the other Mac users. Users with Intel (32bit and 64bit) processors running Mac OS X 10.4 or higher can try Soylatte which is a port of OpenJDK.

What else do I need?

The Windows version comes bundled with most of what you need. For all other platforms the following must be installed in the path of your operating system:

  • mplayer

For ripping CD's you need:


  • cdparanoia (can be used either on Mac OS or Linux, but only with limited functionality)

Optionally either of this encoder/-s can be installed:

  • oggenc
  • lame
  • flac
  • neroAacEnc
  • faac

How do I install mplayer on a Mac?

  • Get mplayer for OS X from: mplayer download page
  • Install mplayer. This requires Rosetta to be present. You will be asked if it is not.
  • Create a folder called mac_tools in the aTunes program directory if it does not already exist
  • Open a terminal and do the following:
    • Use the cd command to go to the mac_tools folder
    • Then type:
      • ln -s /Applications/"MPlayer OS X 2.app"/Contents/Resources/External_Binaries/mplayer.app/Contents/MacOS/mplayer mplayer


After earch start, a dialog asks for the repository

A repository must be selected when using aTunes. However, if you already set a repository in the previous start and songs were found, a configuration file probably is corrupted. The easiest way to solve this is to find the .aTunes folder and delete it (all settings will be lost). It is found in the settings directory.

I'm running aTunes in Linux and an exception is thrown when launching

If you use Linux and see an exception like

Exception in thread "main" java.lang.ClassFormatError: net.sourceforge.atunes.Main   
(unrecognized class file version) 
at java.lang.VMClassLoader.defineClass(libgcj.so.8rh) 
at java.lang.ClassLoader.defineClass(libgcj.so.8rh) 
at java.security.SecureClassLoader.defineClass(libgcj.so.8rh) 
at java.net.URLClassLoader.findClass(libgcj.so.8rh) 
at gnu.gcj.runtime.SystemClassLoader.findClass(libgcj.so.8rh) 
at java.lang.ClassLoader.loadClass(libgcj.so.8rh) 
at java.lang.ClassLoader.loadClass(libgcj.so.8rh) 
at gnu.java.lang.MainThread.run(libgcj.so.8rh) 

you are using GCJ. This virtual machine is not supported. You should use Sun Java Virtual Machine 6. Either edit the aTunes.sh file or change the symlink usually located in /usr/bin to point where the Sun Java Virtual Machine 6 is located.

I don't like the look and feel. How can I change/disable it?

You can change look and feel in the preferences dialog.

To disable the Substance look and feel and use the default Java look and feel, you have to launch aTunes with the param ignore-theme:

  • In Windows: /PATH_TO_ATUNES/aTunes.exe ignore-theme
  • In Linux: /PATH_TO_ATUNES/aTunes.sh ignore-theme

Disabling the Substance look and feel is not recommended and should only be done for debugging purposes by Java developers!

Using aTunes

I have selected repository folders but after that repository is empty

Have you selected repository folders with right mouse button? Often users select with left button, so nothing gets selected.

How can I use hotkeys?

To enable this feature, go to Preferences, Player, and enable option.

The default hotkey settings are:

  • Play/Pause: Ctrl+Alt+P
  • Stop: Ctrl+Alt+S
  • Next: Ctrl+Alt+RIGHT
  • Previous: Ctrl+Alt+LEFT
  • Volume up: Ctrl+Alt+UP
  • Volume down: Ctrl+Alt+DOWN
  • Show/hide window: Ctrl+Alt+W
  • Mute: Ctrl+Alt+M
  • Show song info: Ctrl+Alt+I

How do I put songs on my mp3 or device?

Go to "Device" -> "Connect". Select where your mp3 device is mounted (for Windows users select drive letter)

In navigator panel (left). Browse to songs/artist/album you want to add to your mp3 player, right click and select "Copy to device".

Radio streaming skips or disconnects, what can I do?

Radio streaming depends greatly on a good connection. Other programs can significantly affect the streaming, as can problems with the network. If you experience skipping first check if no other program is accessing the internet or if another user is not sharing the internet connection with you. If you use a high bitrate version of the radio stream, try a low bitrate version if available, as it will be less demanding. Low bitrate will take some time to buffer, so be patient.

I see red folders in navigator. What does it mean?

Red folders is a new feature introduced in aTunes 1.10.0. It is designed to easily find files with incomplete tags.

If you go to Preferences -> Navigator you will see an option "Highlight folders with incomplete tags based on following attributes:" and a list of tag attributes. You can select all the attributes you want, and aTunes will show you in red those folders that contain one or more files with some of these attributes incomplete.

By default this option is enabled and attributes selected are Artist and Album. If you don't like this feature just uncheck it.

Where are my settings saved?

  • Windows: %appdata%\aTunes (Inserting this into Explorer brings you to the right directory)
%appdata% normally is C:\Documents and Settings\user\application data
  • Linux: /home/user/.aTunes (hidden folder)


Is there something I can do to help aTunes developement?

Sure. There are many ways you can help. For one, we badly need document writers and are always looking for translators. If you have programming knowledge, you implement one of the many features. You can also help us in testing our Beta releases. Have a look at Contributing for more informations. Besides this, we are looking for volunteers interested in maintaining the Propose new radio stations. No special skills are required for document writers, translators, beta testers and radio list maintainers, but basic computer and english knowledge are a plus.

How can I download and run aTunes source code?

Here are the steps to get aTunes running in Eclipse:

  1. Download Eclipse, you will also need Java 6 (not 5)
  2. Install Subversion plugin for Eclipse (Subclipse or Subversive)
  3. Install Maven plugin for Eclipse (m2eclipse)
  4. Checkout aTunes from the SVN repository, which is located at
  5. Enable Maven for aTunes
  6. You can start aTunes by simply running the main method in
  7. It is recommended to add "debug multiple-instance" (without the ") as program arguments. This can be done via the "Run Configurations..." dialog in Eclipse


I requested feature X and it has not yet been developed. Why?

First of all, we are currently a small team, and we set priorities to our work, so a feature can be developed several months after being proposed. If you'd like that things go faster you should consider Contributing.

On the other hand, maybe we are not interested on developing a feature, for some reasons:

  • We can't develop all features users request, sometimes features are contradictories.
  • Sometimes a small feature requires a deep change in aTunes architecture, so it requires a big effort. In these cases we usually set a low priority to feature.
  • aTunes is a platform independent application. Some features need use of OS specific routines and libraries. We usually avoid adding features that can be available for one operating system but not for others.


I think I have found a bug. What should I do?

Check if it is not already listed in the Known Bugs section. If it is not listed, you should report this bug to the Sourceforge bug tracking system.

Personal tools