Next Previous Contents

2. Installation

2.1 How to obtain Yammi

Give it a try at The Yammi Homepage.

2.2 Requirements

Mandatory

Yammi needs QT, version 3.x

Optional

For reading id3 tags, id3lib, version 3.8.2 or higher is required (recommended: newest version 3.8.3).

For reading ogg tags and layer information, libvorbis, libvorbisfile and libvorbis-dev are required.

For XMMS support, XMMS, version 1.2.6 or later is required.

For Noatun support, the KDE libraries, version 3.x are required.

Note: You should have either XMMS or Noatun support, or functionality will be very limited.

For listening to songs on a second soundcard during playback on your primary soundcard you need mpg123 (for mp3 files), ogg123 (for ogg files) or play (for wav files).

If you want to use the ripping and encoding function offered from within yammi, you need cdparanoia and (not)lame or other ripping/encoding tools, for details have a look at the script "yammiGrabAndEncode" included in the distribution.

If you want to use certain plugins you might need other programs (such as k3b for the "Burn with K3b" plugins or cdlabelgen for the "Create CD Label" plugin).

...for compiling from sourceIf you want to compile Yammi from source, you need additionally to the abovementioned requirements the following packages:(This list is not complete nor confirmed yet, anyone knows how to find out exactly what one needs?)Xfree86-develqt3-develxmms-devellibz - sources

2.3 Compilation and installation

In order to compile and install Yammi on your system, type the following in the base directory of the Yammi distribution:

% ./configure
% make
% make install

If compilation is successful, the executable "yammi" and an additional script "yammiGrabAndEncode" will be installed in /usr/local/bin/.

2.4 Problems

If you experience problems with compiling or installing, please consult the README file included in the distribution which explains various switches for the configure script that might be necessary on your system.

If you still experience problems, try contacting the developers, not only including information about the problem, but also about your system configuration. If possible, attach the console log of configure and make.

2.5 Deinstallation

In the base directory of the yammi distribution, type

% make uninstall

If you are not upgrading to a new version of Yammi, but want to completely remove all files related to Yammi from your harddisk, you can also delete the directory ".yammi" in your home directory (This deletes your preferences, categories, settings and the complete database!).

2.6 Starting the first time

After successful installation, you can start yammi by typing "yammi" in a shell (if you encounter any problems or want to know what's going on it helps to have a look at the terminal output that yammi creates on the console). On first startup, yammi will create a directory ".yammi" in your home directory, where it will store the song database, preferences settings and logfiles. Before you start scanning your harddisk for songs, you should edit the preferences (Configure -> Settings...) and set the paths to the location of your song collection.


Next Previous Contents