Provided by: alsaplayer-common_0.99.80-5build1_amd64 bug


       alsaplayer - plays various sound files


       alsaplayer [options] [ filename ...]


       This  manual  page documents briefly the alsaplayer command.  This manual page was written
       for the Debian GNU/Linux distribution because the original program does not have a  manual

       alsaplayer is a generic music player that can play back a large amount of file formats.

       If  files are specified on the command line, these files are played.  Otherwise alsaplayer
       plays its playlist from its last run, if any.


       Play the specified file(s). Can be a file or an URL.

              Special filename. Play a  CD.  /dev/cdrom  will  be  used  by  default.  Otherwise,
              AlsaPlayer   will   use   the   device  specified  in  your  config  file  (usually


       These programs follow the usual GNU command line syntax, with long options  starting  with
       two dashes (`-').  A summary of options is included below.

       -c, --config <file>
              Use the given config file for this session.

       -h, --help
              Print this help message.

       -i, --interface <interface>
              Use the specified interface instead of the default one.

       -I, --script <file>
              Specify the script to pass to the interface plugin.

       -l, --startvolume <vol>
              Start with this volume [default=1.0].

       -p, --path <path>
              Set the path alsaplayer looks for add-ons.

       -q, --quiet
              Quiet operation, no output.

       -s, --session-name name
              Name this session "name"

       -v, --version
              Print version of this program.

              Be verbose about the output.

              Do not save playlist content at exit.

   Player control:
       -n, --session #
              Select session # [default=0]

       -e, --enqueue file(s)
              Enqueue file(s) in a running alsaplayer.

       -E, --replace file(s)
              Clears and queues file(s) in a running alsaplayer.

              Get some information about the session.

       --volume #
              Set software volume [0.0-1.0].

              Start playing.

       --stop Stop playing.

              Pause/unpause playing.

       --prev Jump to the previous track.

       --next Jump to the next track.

       --seek <second>
              Jump to the specified second in the current track.

       --relative <second>
              Jump <second> seconds from current position.

       --speed #
              Set the playback speed.  1.0 = normal speed, -1.0 = normal speed backwards

       --jump #
              Jump to the specified playlist track.

              Clear the whole playlist

       --quit Quit the session.

   Sound driver options:
       -d, --device string
              Select the specific device for the output plugin.  For the ALSA plugin, the default
              is     "default".      For     the     JACK     plugin,     the     default      is

       -f, --fragsize #
              Set fragment size in bytes [default=4096].

       -F, --frequency #
              Set the output frequency [default=44100].

       -g, --fragcount #
              Fragment count [default=8].

       -r, --realtime
              Enable  realtime scheduling.  To use this as a normal user, alsaplayer must be SUID

       -o, --output [alsa|esound|jack|nas|null|oss|sgi|sparc]
              Use the specified output driver.

   Experimental options:
              Loop the file.

              Loop the playlist.

              Crossfade playlist entries.


       For use with JACK, -F <sample_rate> is mandatory for best results.  The  value  of  sample
       rate must be the same as the one used by jackd.

       If you forget the -F parameter, the sound can be very bad. The only remedy at that time is
       to restart both jackd and AlsaPlayer.


       With the daemon interface, it is mandatory to add the -s option.  You must process in  two
       steps to get sound with it. First launch the daemon:

       alsaplayer -i daemon -s <name>

       and then add some song:

       alsaplayer -e <>


       The gtk interface provide some basic keyboard controls:

       v      Stop

       x      Play

       c      Pause

       b      Next Song

       z      Previous Song

       g      Seek Forward

       a      Seek Backward

       f      Forward Play

       s      Reverse Play

       t      Speed  Up one musical semitone. (handy for changing the key the song is played back

       q      Speed Down one musical semitone.

       h      Speed Up one comma. (handy to tune the song instead of the guitar when  playing  at
              the same time as listening)

       i      Speed Down one comma.

       r      Volume Up

       w      Volume Down

       l      Loop


       AlsaPlayer  have  a  preferences  file  located  in  ~/.alsaplayer/config.  To  modify the
       preferences setting by hand, you must exit from the running program and  edit  this  file.
       The default value is put in the description below when appropriate:

   General settings
              Specify the default interface.

              Specify the default sound server.

              Specify if it is possible to run multiple AlsaPlayer instances.

              Number of periods in the sound buffer

              Frames per period in the sound buffer

   Output settings
              Output device 1 when using JACK sound server

              Output device 2 when using JACK sound server

   Input settings
              Server used by the cdda input module to retrieve the cddb information.

              Port used by the cdda input module to retrieve the cddb information.

              Device used by the cdda input module to retrieve the CD.

              Must AlsaPlayer retrieve or not the cddb information.

              Size of the input buffer when <filename> is an URL.

              Parse or not the Id3 tags.

   GTK interface settings
              Default path used by the Add file function

              Default path used by the Add file function in the Playlist window

              Default path used by the Load playlist function

              Default path used by the Save playlist function

              Launch or not the playlist window at start up.

              Launch or not the scopes selector window at start up.

              Will functions such as pause use a smooth speed transition.

   GTK2 interface settings
       It use the same options as the GTK interface but with "gtk2_" as prefix instead of "gtk_".

   XOSD interface settings
              Colour used by the XOSD interface.


              Display horizontal offset from the left of the screen

              Set the display time.

              Display vertical offset from the top of the screen

   Scopes settings
              Launch or not the blurscope plugin at start up.
              Launch or not the fftscope plugin at start up.
              Launch or not the levelmeter scope plugin at start up.
              Launch or not the logbar scope plugin at start up.
              Launch or not the spectrumgl scope plugin at start up.

              Height of the spectrumgl scope plugin

              Width of the spectrumgl scope plugin
              Launch or not the spacescope plugin at start up.
              Launch or not the synaescope plugin at start up.


       mikmod(1), mpg123(1).


       This  manual page was written by Ivo Timmermans <>, for the Debian GNU/Linux
       system (but may be used by others).   FILENAME,  GTK,  DAEMON  INTERFACE  and  PREFERENCES
       sections  added  by Dominique Michel <> from the Alsaplayer

                                         8 September 2007                           ALSAPLAYER(1)