NAME

       out123 - play raw PCM audio to an output device

SYNOPSIS

       cat audio.raw | out123 [ options ]

DESCRIPTION

       out123  reads  raw  PCM  data (in host byte order) from standard input and plays it on the
       audio device specified by given options.

OPTIONS

       out123 options may be either the traditional POSIX one letter options, or  the  GNU  style
       long options.  POSIX style options start with a single ``-'', while GNU long options start
       with ``--''.  Option arguments (if needed) follow separated  by  whitespace  (not  ``='').
       Note  that  some  options  can be absent from your installation when disabled in the build
       process.

       -o module, --output module
              Select audio output module. You can provide a comma-separated list to use the first
              one that works.

       --list-modules
              List the available modules.

       -a dev, --audiodevice dev
              Specify  the  audio  device  to  use.   The  default  is  system-dependent (usually
              /dev/audio or /dev/dsp).  Use this option if you have multiple  audio  devices  and
              the default is not what you want.

       -s, --stdout
              The  audio  samples are written to standard output, instead of playing them through
              the audio device.  The output format is the same as the input ... so in this  mode,
              mpg123 acts like the standard tool  cat.

       -O file, --outfile
              Write  raw  output  into a file (instead of simply redirecting standard output to a
              file with the shell).

       -w file, --wav
              Write output as WAV file file , or standard output if - is used as file  name.  You
              can  also  use --au and --cdr for AU and CDR format, respectively. Note that WAV/AU
              writing to non-seekable files or redirected stdout needs some thought.  The  header
              is  written with the first actual data. The result of decoding nothing to WAV/AU is
              a file consisting just of the header when it is seekable and  really  nothing  when
              not (not even a header). Correctly writing data with prophetic headers to stdout is
              no easy business.

       --au file
              Write to file in SUN audio format.  If - is used as the filename, the  AU  file  is
              written to stdout. See paragraph about WAV writing for header fun with non-seekable
              streams.

       --cdr file
              Write to file as a CDR (CD-ROM audio, more correctly CDDA for Compact Disc  Digital
              Audio).  If - is used as the filename, the CDR file is written to stdout.

       -m, --mono
              Set for single-channel audio (default is two channels, stereo).

       --stereo
              Select stereo output (2 channels, default).

       -r rate, --rate rate
              Set  sample  rate  in  Hz (default: 44100). If this does not match the actual input
              sampling rate, you get changed pitch. Might be intentional;-)

       -e enc, --encoding enc
              Choose output sample encoding. Possible  values  look  like  f32  (32-bit  floating
              point), s32 (32-bit signed integer), u32 (32-bit unsigned integer) and the variants
              with different numbers of bits (s24, u24,  s16,  u16,  s8,  u8)  and  also  special
              variants  like  ulaw  and  alaw  8-bit.   See  the  output of out123's longhelp for
              actually available encodings.  Default is s16.

       -o h, --headphones
              Direct audio output to the headphone connector (some hardware only; AIX, HP, SUN).

       -o s, --speaker
              Direct audio output to the speaker  (some hardware only; AIX, HP, SUN).

       -o l, --lineout
              Direct audio output to the line-out connector (some hardware only; AIX, HP, SUN).

       -b size, --buffer size
              Use an audio output buffer of size Kbytes.  This is useful to bypass short  periods
              of  heavy  system  activity,  which  would  normally  cause  the audio output to be
              interrupted.  You should specify a buffer size of at least 1024 (i.e. 1  Mb,  which
              equals  about  6 seconds of usual audio data) or more; less than about 300 does not
              make much sense.  The default is 0, which turns buffering off.

       --preload fraction
              Wait for the buffer to be filled to fraction  before  starting  playback  (fraction
              between 0 and 1). You can tune this prebuffering to either get sound faster to your
              ears or safer uninterrupted web radio.  Default is 1 (wait for full  buffer  before
              playback).

       -t, --test
              Test mode.  The audio stream is read, but no output occurs.

       -v, --verbose
              Increase the verbosity level.

       -q, --quiet
              Quiet.  Suppress diagnostic messages.

       --aggressive
              Tries to get higher priority

       -T, --realtime
              Tries  to  gain realtime priority.  This option usually requires root privileges to
              have any effect.

       -?, --help
              Shows short usage instructions.

       --longhelp
              Shows long usage instructions.

       --version
              Print the version string.

AUTHORS

       Maintainer:
              Thomas Orgis <maintainer@mpg123.org>, <thomas@orgis.org>

       Creator (ancestry of code inside mpg123):
              Michael Hipp

       Uses code or ideas from various people, see the AUTHORS file accompanying the source code.

LICENSE

       out123 is licensed under the GNU Lesser/Library General Public License, LGPL, version  2.1
       .

WEBSITE

       http://www.mpg123.org
       http://sourceforge.net/projects/mpg123

                                           10 May 2014                                  out123(1)