.TH AQUALUNG 1 "27 September 2006".SH NAMEaqualung \- Music player for GNU/Linux.SH SYNOPSIS\fBaqualung\fR \-\-help.br\fBaqualung\fR \-\-version.br\fBaqualung\fR [\-\-output (oss|alsa|jack|win32)] [options] [file1 [file2 ...]].SH DESCRIPTIONAqualung is a music player for the GNU/Linux operating system. Itplays audio files from your filesystem and has the feature ofinserting \fBno gaps\fR between adjacent tracks. It also supports highquality sample rate conversion between the file and the output device,when necessary.Almost all sample-based, uncompressed formats (e.g. WAV, AIFF, AUetc.)  are supported. Files encoded with FLAC (the Free Lossless AudioCodec), Ogg Vorbis, Ogg Speex, MPEG Audio (including the infamous MP3format) and MOD audio formats (MOD, S3M, XM, IT, etc.), Musepack andMonkey's Audio Codec are also supported. The program can play themusic through OSS, ALSA or using the JACK Audio Connection Kit, oreven the Win32 Sound API (available only under Cygwin).Aqualung supports the LADSPA 1.1 plugin standard. You can use anysuitable plugin to enhance the music you are listening to.Other features of the program are internally working volume andbalance controls (not touching the soundcard mixer), multiple skinsupport, random seeking during playback, track repeat, list repeat andshuffle mode (besides normal playback). Aqualung will come up in thesame state as it was when you closed it, including playback modes,volume and balance settings, currently processing LADSPA plugins,window sizes, positions and visibility, and other miscellaneousoptions. Aqualung has the ability to display and edit Ogg Xiphcomments, ID3v1, ID3v2 and APE tags found in files that support them.You can control any running instance of the program remotely from thecommand line (start, stop, pause etc.). Remote loading or enqueueingsoundfiles as well as complete playlists is also supported.In addition to all this, Aqualung provides a so-called Music Storethat is an XML-based music database, capable of storing variousmetadata about music on your computer (including, but not limited to,the names of artists, and the titles of records and tracks). You can(and should) organize your music into trees of Artists/Records/Tracks,thereby making life easier than with the all-in-one Winamp/XMMSplaylist. Importing file metadata (ID3v1, ID3v2 tags, Ogg Xiphcomments, APE metadata) into the Music Store as well as getting tracknames from a CDDB/Freedb database is supported.Please refer to the documentation provided with the program for adetailed description of features, usage tips and troubleshootingissues. This manual page is only an abstract from the documentation,and documents only the program's command line interface for quickreference..SH OPTIONSNormally you should be able to start Aqualung without anyoptions. This case the output device will be selected by probing for ausable driver (in order of JACK, ALSA, OSS) with default parameters.If no driver could be started with default parameters, or you want toexplicitly choose a suitable output configuration, you have to tellthe program which output device to use. This is possible with the -o(--output) option. There are specific optional parameters for all fouroutput drivers. You can also specify which sample rate converter youwant to use, or request a list of available converters. You may alsocontrol another instance of the program remotely, or add files to theplaylist.The disk thread is a background worker thread doing file decoding andsample rate conversion. If you experience short audio dropouts causedby other programs (e.g. web browser loading a complex page) try to runthis thread at realtime with the -D (and optionally -Y) options..TP.B General options:.TP\-D, \-\-disk-realtime.brTry to use realtime (SCHED_FIFO) scheduling for disk thread..TP\-Y, \-\-disk-priority <int>.brWhen running \-D, set scheduler priority to <int> (defaults to 1)..br.TP\-l, \-\-show-pl [yes|no].brChange visibility of Playlist..TP\-m, \-\-show-ms [yes|no].brChange visibility of Music Store..TP.B Options relevant to ALSA output:.TP\-d, \-\-device <name>.brSet the output device (defaults to plughw:0,0)..TP\-p, \-\-period <int>.brSet ALSA period size (defaults to 8192)..TP\-n, \-\-nperiods <int>.brSpecify the number of periods in hardware buffer (defaults to 2)..TP\-r, \-\-rate <int>.brSet the output sample rate..TP\-R, \-\-realtime.brTry to use realtime (SCHED_FIFO) scheduling for ALSA output thread..TP\-P, \-\-priority <int>.brWhen running \-R, set scheduler priority to <int> (defaults to 1)..TP.B Options relevant to OSS output:.TP\-d, \-\-device <name>.brSet the output device (defaults to /dev/dsp)..TP\-r, \-\-rate <int>.brSet the output sample rate..TP.B Options relevant to JACK output:.TP\-a[<port_L>,<port_R>], \-\-auto[=<port_L>,<port_R>].brAuto-connect output ports to given JACK ports (defaults to first twohardware playback ports)..TP\-c, \-\-client <name>.brSet client name (needed if you want to run multiple instances of the program)..PNOTE: In the case when JACK output has been selected as part of theautomatic output device detection, the -a option is implicitlyapplied..TP.B Options relevant to Win32 output:.TP\-r, \-\-rate <int>.brSet the output sample rate..TP.B Options relevant to the Sample Rate Converter:.TP\-s[<int>], \-\-srctype[=<int>].brChoose the SRC type, or print the list of available types if no numbergiven. The default is SRC type 4 (Linear Interpolator)..TP.B Options for remote cue control:.PPNote that remote controlling of instances is only possible if theinstance you want to send a command to is running as the same user asyou are when you issue the remote command..TP\-N, \-\-session <int>.brSpecify the instance number to send the remote command to. Instancesare numbered on a per user basis, starting with 0. Except for thezero-th instance (started first), the instance number is displayed inthe title bar of the main window (e.g.: Aqualung.3). If you don't usethis option, the following options will control the zero-th instanceby default, except for -L which defaults to the present instance (soas to be able to start playback immediately from the command line)..TP\-B, \-\-back.brJump to previous track..TP\-F, \-\-fwd.brJump to next track..TP\-L, \-\-play.brStart playing..TP\-U, \-\-pause.brPause playback, or resume if already paused..TP\-T, \-\-back.brStop playback..TP\-V, \-\-volume [m|M]|[=]<val>.brAdjust the volume. m/M means mute; if = is present, the remoteinstance's volume control will be set to the value specified,otherwise, the volume will be adjusted by the supplied (signed)value. The values are in dB units..TP\-Q, \-\-quit.brTerminate remote instance..TP.B Options for file loading:.PPYou may specify filenames on the command line. These may be ordinarysoundfiles playable by Aqualung, or playlist files you savedearlier. The program will decide if a file is a playlist, and add itscontents accordingly. In addition to Aqualung's native (XML) playlistformat, the program will load M3U and PLS playlists whenever possible.If you used the --session option (see above), the files will be sentto the Aqualung instance you specified. Otherwise a new instance willstart up with the files you specified. Note that if you enabled the"Save and restore the playlist on exit/startup" option in the programsetup dialog, the files you specify will be loaded \fBafter\fR theautomatically loaded ones..TP\-E, \-\-enqueue.brEnqueue added files to the playlist instead of loading them (whichremoves the previous contents of the playlist). Use this if you wantto keep the existing items in the playlist..TP.B Examples:.br$ aqualung -s3 -o alsa -R -r 48000 -d hw:0,0 -p 2048 -n 2.br$ aqualung --srctype=1 --output oss --rate 96000.br$ aqualung -o jack -a -E `find ./ledzeppelin/ -name "*.flac"`.PPDepending on the compile-time options, not all file formatsand output drivers may be usable. Use the --version option to see thelist of compiled-in features..SH FILES.TP~/.aqualung.brDirectory containing user settings..TP~/.aqualung/config.xml.brGUI (skin, window size/position, etc.) and other settings..TP~/.aqualung/plugin.xml.brList of running plugins and all their settings..TP~/.aqualung/playlist.xml.brAutomatically saved and restored playlist (if you enable this feature)..TP~/.aqualung/<skin-name>.brLocally available skin <skin-name>..TP${prefix}/share/aqualung/skin.brSystem-wide skin directory..SH ENVIRONMENTAqualung obeys two environment variables concerning LADSPA plugins..TP.B LADSPA_PATHLADSPA_PATH should contain a colon-separated list of paths to searchfor LADSPA plugin .so files..TP.B LADSPA_RDF_PATHLADSPA_RDF_PATH should contain a colon-separated list of paths to RDFmetadata files about these plugins..PPWhen any of these is not specified, the program will use sensibledefaults and look in the obvious places..SH AUTHORS.brTom Szilagyi <tszilagyi@users.sourceforge.net>.brPeter Szilagyi <peterszilagyi@users.sourceforge.net>.brTomasz Maka <pasp@users.sourceforge.net>.SH BUGSYes. Report them to our bugtracker at <http://aqualung.sf.net/mantis>or write to our mailing list (the subscription interface is accessiblefrom the project homepage)..SH HOMEPAGEPlease go to http://aqualung.sf.net to download the latest version,access the Aqualung bugtracker and subscribe to the mailing list..SH USER'S MANUALThe User's Manual is available at ${prefix}/share/aqualung/doc in LyXand PDF formats.