out123(1)
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 <[email protected]>, <[email protected]>
- 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 .
