Man Linux: Main Page and Category List


       adplay - AdPlay/UNIX console-based OPL2 audio player


       adplay [OPTION]... FILE...


       AdPlay/UNIX  is  AdPlug’s UNIX console-based frontend. It tries to play
       back all given FILEs, using one of many available output mechanisms.

       AdPlay/UNIX plays endlessly, if only one file is given.  With  multiple
       files,  it  plays them in a sequence and exits after the last file. The
       same can also be accomplished with only  one  file,  by  using  the  -o
       option. When using the disk writer, -o is implied.


       adplay returns 0 on successful operation. 1 is returned otherwise.


       AdPlay/UNIX can play back using many different output mechanisms, which
       can be selected with the -O argument.  The  availability  of  a  method
       depends  on  compile-time  settings.  Available methods are printed out
       after the help text, displayed with --help.

       Next is a brief description of all output mechanisms,  following  their

   oss -- Open Sound System (OSS) driver
       This output method is available on most Linux and other UNIX systems.

   null -- Total silence
       Discards anything sent to it. It can be useful for testing purposes.

   disk -- Disk writer
       Writes its output to a file in Microsoft RIFF WAVE format.

   esound -- EsounD output
       Creates  a  socket connection to an EsounD server and streams the audio
       to it.

   qsa -- QNX Sound Architecture (QSA) driver
       Uses the QNX system’s standard output method.

   sdl -- Simple Directmedia Layer (SDL) driver
       Uses the SDL library for  sound  output.  The  library  has  a  broader
       platform  support  than any of the other output methods. Thus, it could
       be useful on some exotic systems.

   alsa -- Advanced Linux Sound Architecture (ALSA) driver
       Uses the standard output method on newer Linux systems.

   ao -- libao driver
       Libao is a  cross-platform  audio  library  with  very  broad  platform
       support.  Might  be  useful on systems, where SDL is not available, and
       generally to do tricky things.


       The order of the option commandline parameters is not important, except
       for the -d option, which always has to be specified after an -O option.

   Output selection:
       -O, --output=OUTPUT
              Specify  output  mechanism.  Available  mechanisms   depend   on
              compilation  settings  and  are  printed  on  --help  output.  A
              reasonable default  is  automatically  selected,  based  on  the
              availability of the output mechanisms.

   OSS driver (oss) specific:
       -d --device=FILE
              Set  sound  output  device  file  to  FILE.  This is /dev/dsp by

   Disk writer (disk) specific:
       -d --device=FILE
              Write sound data to FILE. The data is written in Microsoft  RIFF
              WAVE  format  (little-endian).  You  can specify a single ’-’ to
              write to stdout instead. This option has no default and must  be
              specified when the disk writer is to be used!

   EsounD output (esound) specific:
       -d --device=URL
              Connect   to   "hostname:port"   combination  in  URL.  Example:
              "". The default is "localhost:16001".

   ALSA driver (alsa) specific:
       -d --device=DEVICE
              Set sound  output  device  to  DEVICE.  This  is  plughw:0,0  by

   Playback quality:
       -8, --8bit
              Use only 8-bit samples for playback.

              Use only 16-bit samples for playback (default).

       -f, --freq=FREQ
              Set  playback  frequency  to  FREQ,  in  Hz.  This is 44100Hz by

              Use only stereo samples for playback. The sound stream  is  just
              doubled,  no  further  audio  processing is done. This option is
              pretty useless unless you have very obscure audio hardware  that
              only  accepts stereo streams. AdPlug only generates mono streams
              because the OPL2 only generates mono sound.

       --mono Use only mono samples for playback (default).

       -b --buffer=SIZE
              Set sound buffer size to  SIZE  samples.  If  you  notice  sound
              skipping  with  the  default setting, try a greater buffer size.
              Note that this is measured in samples, not bytes! This  is  2048
              samples  by  default.  Only  the OSS, SDL, ALSA and libao output
              drivers support this option.

   Informative output:
       -i --instruments
              Display instrument names (if available).

       -r --realtime
              Display realtime playback information, while playing. This  will
              display  a  one-line  status  bar, containing essential playback

       -m --message
              Display the song message (if available).

              -s --subsong=N Play subsong  number  N,  instead  of  the  first
              subsong.  Only  useful  for  file  formats that support multiple

       -o --once
              Play just once, don’t loop. This will exit adplay after the song
              ended. This is the default when multiple FILEs are given.

       -D, --database=FILE
              Additionally   use  database  file  FILE.  This  option  may  be
              specified multiple times. Each  database  file  is  additionally
              merged  with the others, creating one large database on the fly.

       -q, --quiet
              Be more quiet.

       -v, --verbose
              Be more verbose.

       -h, --help
              Show summary of options.

       -V, --version
              Show version of program.


       Simon Peter <>