From aTunes Wiki

(Difference between revisions)
Jump to: navigation, search
(What else do I need?)
Line 59: Line 59:
== Running ==
== Running ==
=== 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:
*Windows: C:\Documents and Settings\user\.aTunes
*Linux: /home/user/.aTunes (hidden folder)
=== I'm running aTunes in Linux and an exception is thrown when launching ===
=== I'm running aTunes in Linux and an exception is thrown when launching ===

Revision as of 13:53, 9 June 2008

This page contains common questions asked about aTunes. If you don’t find the question that are looking for, 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, Linux and Sun Solaris.

What audio formats are supported?

Many popular formats, such as mp3. To see 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 multiplatform installer from our own website. For Mandriva and Suse Linux users rpm packages are ready. In Mandriva enable the Non-free and Non-free Backports repositories in the Control Center, then aTunes can be installed. For Suse follow the instructions on the Packman site.

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

Where do I get Java?

You can download the latest Java version at http://www.java.com/download/ Many Linux distribution are providing a Java 6 package 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 shipping 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:

  • cdda2wav or icedax [since 1.9.0: cdparanoia can be used 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
  • Open a terminal and do the following:
    • cd /usr/bin
    • sudo ln -s /Applications/"MPlayer OS X 2.app"/contents/Resources/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:

  • Windows: C:\Documents and Settings\user\.aTunes
  • Linux: /home/user/.aTunes (hidden folder)

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 look and feel. How can I change/disable it?

You can change look and feel in Preferences dialog.

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

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

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?

Global hotkeys are supported from version 1.8.2 for Windows system only. To enable this feature, go to Preferences, Player, and enable option.

Hotkeys 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.


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 Radio Stations list in xml format. 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. Checkout aTunes_HEAD from the SVN repository, which is at
  4. You can start aTunes by simply running the main method in
  5. It would be helpful if you add "debug multiple-instance" (without the ") as program arguments, this can be done via the "Open Run Dialog..." dialog in Eclipse


I requested feature X and it has not 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