DragonFly On-Line Manual Pages
out123(1) DragonFly General Commands Manual out123(1)
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)