Scroll to navigation
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.
- --name name
- Set the name of this instance, possibly used in various places. This sets
the client name for JACK output.
- -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, out123 acts like the standard tool cat.
This shortcut is equivalent to ``-o raw -a -''.
- -O file, --outfile
- Write raw output into a file (instead of simply redirecting standard
output to a file with the shell). This shortcut is equivalent to ``-o raw
-a file''.
- -w file, --wav
- Write output as WAV file file , or standard output if - is
or the empty string 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. This shortcut is
equivalent to ``-o wav -a file''.
- --au file
- Write to file in SUN audio format. If - or the empty string is used
as the filename, the AU file is written to stdout. See paragraph about WAV
writing for header fun with non-seekable streams. This shortcut is
equivalent to ``-o au -a file''.
- --cdr file
- Write to file as a CDR (CD-ROM audio, more correctly CDDA for
Compact Disc Digital Audio). If - is or the empty string used as the
filename, the CDR file is written to stdout. This shortcut is equivalent
to ``-o cdr -a file''.
- -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;-)
- -c count, --channels count
- Set channel count to given value.
- -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.
- -m, --mono
- Set for single-channel audio (default is two channels, stereo).
- --stereo
- Select stereo output (2 channels, default).
- --list-encodings
- List known encoding short and long names to standard output.
- --test-format
- Check if given format is supported by given driver and device (in command
line before encountering this), silently returning 0 as exit value if it
is the case.
- --test-encodings
- Print out the short names of encodings supported with the current
setup.
- --query-format
- If the selected driver and device communicate some default accepted
format, print out a command line fragment for out123 setting that format,
always in that order: --rate <r> --channels <c> --encoding
<e>
- -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 0.2 (changed from 1 since version 1.23).
- --devbuffer seconds
- Set device buffer in seconds; <= 0 means default value. This is the
small buffer between the application and the audio backend, possibly
directly related to hardware buffers.
- -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 .