manual.lyx

Aqualung is an advanced music player primarily targeted for the GNU/Linux operating system, but als

\end_layout

\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text

\begin_layout Standard
restart current track
\end_layout

\end_inset
</cell>
</row>
<row topline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

\family roman
\series medium
\shape up
\size normal
\emph off
\bar no
\noun off
\color none
/
\end_layout

\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

\family roman
\series medium
\shape up
\size normal
\emph off
\bar no
\noun off
\color none
volume down
\end_layout

\end_inset
</cell>
</row>
<row topline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

\family roman
\series medium
\shape up
\size normal
\emph off
\bar no
\noun off
\color none
*
\end_layout

\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

\family roman
\series medium
\shape up
\size normal
\emph off
\bar no
\noun off
\color none
volume up
\end_layout

\end_inset
</cell>
</row>
<row topline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard
i, I
\end_layout

\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text

\begin_layout Standard
bring up the File Info dialog for currently played track
\end_layout

\end_inset
</cell>
</row>
<row topline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

\family roman
\series medium
\shape up
\size normal
\emph off
\bar no
\noun off
\color none
Alt+/
\end_layout

\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

\family roman
\series medium
\shape up
\size normal
\emph off
\bar no
\noun off
\color none
balance towards left
\end_layout

\end_inset
</cell>
</row>
<row topline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

\family roman
\series medium
\shape up
\size normal
\emph off
\bar no
\noun off
\color none
Alt+*
\end_layout

\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

\family roman
\series medium
\shape up
\size normal
\emph off
\bar no
\noun off
\color none
balance towards right
\end_layout

\end_inset
</cell>
</row>
<row topline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

\family roman
\series medium
\shape up
\size normal
\emph off
\bar no
\noun off
\color none
Alt+S
\end_layout

\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

\family roman
\series medium
\shape up
\size normal
\emph off
\bar no
\noun off
\color none
show/hide Music Store
\end_layout

\end_inset
</cell>
</row>
<row topline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

\family roman
\series medium
\shape up
\size normal
\emph off
\bar no
\noun off
\color none
Alt+L
\end_layout

\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

\family roman
\series medium
\shape up
\size normal
\emph off
\bar no
\noun off
\color none
show/hide Playlist
\end_layout

\end_inset
</cell>
</row>
<row topline="true" bottomline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

\family roman
\series medium
\shape up
\size normal
\emph off
\bar no
\noun off
\color none
Alt+X
\end_layout

\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text

\begin_layout Standard

\family roman
\series medium
\shape up
\size normal
\emph off
\bar no
\noun off
\color none
show/hide LADSPA patch builder
\end_layout

\end_inset
</cell>
</row>
<row bottomline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard
k, K
\end_layout

\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text

\begin_layout Standard
show Skin Chooser
\end_layout

\end_inset
</cell>
</row>
<row bottomline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard
o, O
\end_layout

\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text

\begin_layout Standard
show Settings
\end_layout

\end_inset
</cell>
</row>
<row bottomline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard
1
\end_layout

\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text

\begin_layout Standard
toggle repeat
\end_layout

\end_inset
</cell>
</row>
<row bottomline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard
2
\end_layout

\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text

\begin_layout Standard
toggle repeat all
\end_layout

\end_inset
</cell>
</row>
<row bottomline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard
3
\end_layout

\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text

\begin_layout Standard
toggle shuffle
\end_layout

\end_inset
</cell>
</row>
<row bottomline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard
ESC
\end_layout

\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard
hide all windows (works only with systray support)
\end_layout

\end_inset
</cell>
</row>
<row bottomline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text

\begin_layout Standard
Ctrl+Q
\end_layout

\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text

\begin_layout Standard
quit Aqualung
\end_layout

\end_inset
</cell>
</row>
</lyxtabular>

\end_inset


\end_layout

\begin_layout Subsection
Music Store
\begin_inset LatexCommand \label{sub:Music-Store}

\end_inset


\end_layout

\begin_layout Subsubsection
Overview
\end_layout

\begin_layout Standard
The Music Store is a simple database of all your music.
 The central philosophy of this program is that you have a large storage
 (ideally an entire hard drive or a separate partition) to store all your
 music files.
 This is not necessary for the program to work.
 The audio files can be scattered around your system as long as you have
 read permissions to them.
 However, it is strongly recommended that you devote a separate directory
 for all the music (for example, /music would be a convenient place to store
 files that are owned by root, but readable by all users).
 Moreover, you can maintain several collections on different machines this
 way, and share them with other users via nfs, while keeping a (probably
 smaller) collection on your local hard drive.
\end_layout

\begin_layout Standard
In these central directories, create subdirectories for each artist you
 have records from.
 The directory names do not have to contain the exact names, you can for
 example create /music/ledzep for Led Zeppelin, /music/crimson for King
 Crimson, /music/hendrix for Jimi Hendrix and so on.
 In these directories, create subdirectories for each record you have.
 Once again, the directory names for the records do not need to fully contain
 the record titles; they can be short and without spaces and special characters.
\end_layout

\begin_layout Standard
In the directories of records, you should cdparanoia the records, and have
 the resulting file names intact.
 Yes, you don't need to rename track01.cdda.wav to 01_Lark's Tongues In Aspic,
 Part One.wav -- this would be very unhealthy to do anyway.
\end_layout

\begin_layout Standard
So you have a bunch of directories containing lots of tracks.
 Now you can add all this to the Music Store, additionally specifying metadata
 about Artists, Records and Tracks.
 One such metadata is the actual name of these items instead of the directory
 and file names you have on your filesystem.
\end_layout

\begin_layout Standard
To do so, you will utilize the popup menus in the Music Store window.
 When you have nothing initially, all that pops up is an option to create
 a new store, which is a top-level element holding artists.
 When creating a new store, you have to specify a file on your filesystem
 to hold all data about the artists, records and tracks in this store.
 Note that this creates an empty store; for adding an already existing database
 file, use the Settings/Music Store interface.
 We suggest that you place this file somewhere next to the audio files,
 so it will be available along with the music.
 This is particularly beneficial if you plan to share the music directory
 among other users.
\end_layout

\begin_layout Standard
Now clicking on the store with the right mouse button will let you add an
 artist to it.
 When you have at least one artist in a store, right-clicking on it will
 let you add a record to them.
 When you have a record, the popup menu will have the option to add tracks
 to the record.
\end_layout

\begin_layout Standard
You don't have to add all the tracks to all records one by one, if you already
 have the audio files from which you want to create the record.
 When adding a record to an artist, the dialog that comes up has an option
 that says `Auto-create tracks from these files', where you can select a
 bunch of files.
 Ideally, when you have the tracks of a record in one directory as described
 above, this will be quite easy.
 And if you didn't mess with the cdparanoia-given names trackXX.*, the tracks
 will be in the right order without further attention.
\end_layout

\begin_layout Standard
Now all you have to do is set the correct visible names for the tracks,
 which is quite easy due to the CDDB/Freedb support.
\end_layout

\begin_layout Subsubsection
Building or Updating store from filesystem
\end_layout

\begin_layout Standard
You might think that the way stores are built up and filled with data is
 painfully slow and exhaustive -- especially if you already own a large
 music collection, and cannot bring yourself to add each record one by one.
 Luckily Aqualung comes with a Music Store builder facility, which allows
 you to easily create a store from your audio files.
 However, it requires the collection to be organized in a music/artist/record/tr
ackXX.* filesystem structure, which is one more argument for doing it this
 way.
\end_layout

\begin_layout Standard
The builder can gain information about your music from three sources: metadata
 (if your audio files are correctly tagged), CDDB query (if you compiled
 Aqualung with CDDB support) and the filesystem names of the audio files
 themselves.
\end_layout

\begin_layout Standard
If you are up to building a new store, first create an empty store (right-click
 in Music Store, then choose the `Create empty store' item), then right-click
 on the new store and choose `Build store from filesystem'.
 You will be shown the builder dialog with several options broken down into
 four notebook pages.
 Later, if you only want to update the content of a store, you can start
 a build process on a non-empty store as well.
\end_layout

\begin_layout Standard
On the `General' page you have to select the root directory of your music
 collection, the one which contains a directory for each artist.
 The priority of the metadata and CDDB lookup can be set there too (filename
 transformation is always the last step, if the other two have both failed).
 The priority applies independently to the artist name, record name and
 track titles, so each string will be set from the highest priority source
 that provides the necessary data.
 Thus it is possible that the artist and e.g.\InsetSpace ~
tracks 1-5 are filled with metadata,
 while the record name and the rest of the track titles are set after a
 CDDB lookup.
 In case of multiple matches (e.g.\InsetSpace ~
through CDDB query, or more than one track