{
    "mode": "man",
    "parameter": "out123",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/out123/1/json",
    "generated": "2026-06-15T18:53:42Z",
    "synopsis": "cat audio.raw | out123 [ - ] [ options  ]\nout123 [ options ] filename [ filename ... ]\nout123 --wave-freq freq1[,freq2,...] [ options ]\nout123 --source geiger [ options ]",
    "sections": {
        "NAME": {
            "content": "out123 - send raw PCM audio or a waveform pattern to an output device\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "cat audio.raw | out123 [ - ] [ options  ]\n\nout123 [ options ] filename [ filename ... ]\n\nout123 --wave-freq freq1[,freq2,...] [ options ]\n\nout123 --source geiger [ options ]\n\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "out123  reads raw PCM data (in host byte order) from standard input and plays it on the audio\ndevice specified by given options.  Alternatively, it can generate periodic or random signals\nfor playback itself.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "out123  options may be either the traditional POSIX one letter options, or the GNU style long\noptions.  POSIX style options start with a single '-', while  GNU  long  options  start  with\n'--'.  Option arguments (if needed) follow separated by whitespace (not '=').  Note that some\noptions can be absent from your installation when disabled in the build process.\n\n--name name\nSet the name of this instance, possibly used in various places. This sets  the  client\nname for JACK output.\n",
            "subsections": [
                {
                    "name": "-o",
                    "content": "Select  audio  output  module. You can provide a comma-separated list to use the first\none that works.  Also see -a.\n",
                    "flag": "-o"
                },
                {
                    "name": "--list-modules",
                    "content": "List the available modules.\n",
                    "long": "--list-modules"
                },
                {
                    "name": "--list-devices",
                    "content": "List the available output devices for given output module. If there is no  functional‐\nity  to  list  devices  in the chosen module, an error will be printed and out123 will\nexit with a non-zero code.\n",
                    "long": "--list-devices"
                },
                {
                    "name": "-a --audiodevice",
                    "content": "Specify the audio device to use.  The default as well as the possible values depend on\nthe  active output. For the JACK output, a comma-separated list of ports to connect to\n(for each channel) can be specified.\n",
                    "flag": "-a",
                    "long": "--audiodevice"
                },
                {
                    "name": "-s --stdout",
                    "content": "The audio samples are written to standard output, instead of playing them through  the\naudio  device.  The output format is the same as the input ... so in this mode, out123\nacts similar the standard tool  cat, possibly with some  conversions  involved.   This\nshortcut is equivalent to '-o raw -a -'.\n",
                    "flag": "-s",
                    "long": "--stdout"
                },
                {
                    "name": "-S --STDOUT",
                    "content": "This  variant  additionally  writes  the data to stdout, while still playing it on the\noutput device. So it is more like some flavour of tee than a cat.\n",
                    "flag": "-S",
                    "long": "--STDOUT"
                },
                {
                    "name": "-O --outfile",
                    "content": "Write raw output into a file (instead of simply redirecting standard output to a  file\nwith the shell).  This shortcut is equivalent to '-o raw -a file'.\n",
                    "flag": "-O",
                    "long": "--outfile"
                },
                {
                    "name": "-w --wav",
                    "content": "Write output as WAV file file , or standard output if - is or the empty string used as\nfile name. You can also use --au and --cdr for AU and CDR format,  respectively.  Note\nthat WAV/AU writing to non-seekable files or redirected stdout needs some thought. The\nheader is written with the first actual data. The result of decoding nothing to WAV/AU\nis  a  file  consisting just of the header when it is seekable and really nothing when\nnot (not even a header). Correctly writing data with prophetic headers to stdout is no\neasy business.  This shortcut is equivalent to '-o wav -a file'.\n\n--au file\nWrite  to file in SUN audio format.  If - or the empty string is used as the filename,\nthe AU file is written to stdout. See paragraph about WAV writing for header fun  with\nnon-seekable streams.  This shortcut is equivalent to '-o au -a file'.\n\n--cdr file\nWrite to file as a CDR (CD-ROM audio, more correctly CDDA for Compact Disc Digital Au‐\ndio).  If - is or the empty string used as the filename, the CDR file  is  written  to\nstdout.  This shortcut is equivalent to '-o cdr -a file'.\n",
                    "flag": "-w",
                    "long": "--wav"
                },
                {
                    "name": "-r --rate",
                    "content": "Set  sample  rate in Hz (default: 44100). If this does not match the actual input sam‐\npling rate, you get changed pitch. Might be intentional;-)\n",
                    "flag": "-r",
                    "long": "--rate"
                },
                {
                    "name": "-R --inputrate",
                    "content": "Set input sample rate to a different value. This triggers  resampling  if  the  output\nrate is indeed different. See --resample.\n\n--speed factor\nSpeed up/down playback by that factor using resampling. See --resample.\n\n--resample method\nThis  chooses the method for resampling between differing sampling rates or to apply a\nchange in tempo. You can choose between two variants of  the  syn123  resampler:  fine\n(the  default) and dirty. The fine one features 108 dB dynamic range and at worst-case\n84% bandwidth. The dirty one uses a bit less CPU time (not that much, though)  by  re‐\nducing  the dynamic range to 72 dB with worst-case bandwidth of 85%. The exact proper‐\nties vary with the sampling rate ratio, as there is interpolation  of  filter  coeffi‐\ncients involved.\n",
                    "flag": "-R",
                    "long": "--inputrate"
                },
                {
                    "name": "-c --channels",
                    "content": "Set channel count to given value.\n",
                    "flag": "-c",
                    "long": "--channels"
                },
                {
                    "name": "-C --inputch",
                    "content": "Set  input  channel count to a differnt value than for output. This probably means you\nwant some remixing. Also see --mix.\n",
                    "flag": "-C",
                    "long": "--inputch"
                },
                {
                    "name": "-e --encoding",
                    "content": "Choose output sample encoding. Possible values look like f32 (32-bit floating  point),\ns32  (32-bit signed integer), u32 (32-bit unsigned integer) and the variants with dif‐\nferent numbers of bits (s24, u24, s16, u16, s8, u8) and  also  special  variants  like\nulaw  and  alaw 8-bit.  See the output of out123's longhelp for actually available en‐\ncodings.  Default is s16.\n\n--endian choice\nSelect output endianess (byte order). Choice is big, little, or native, which  is  the\ndefault.  The processing can only work in native mode, so you need to specify input or\noutput byte order if that does not match your machine. This also sets the input  endi‐\naness if that is not set separately. See also --inputend and --byteswap.\n",
                    "flag": "-e",
                    "long": "--encoding"
                },
                {
                    "name": "-E --inputenc",
                    "content": "Specify input encoding different from output encoding for conversion.\n\n--inputend choice\nSelect  input  endianess (byte order). By default it is the same as output byte order.\nSee --endian.\n",
                    "flag": "-E",
                    "long": "--inputenc"
                },
                {
                    "name": "--byteswap",
                    "content": "A switch to trigger swapping of byte order just before output, after any other  trans‐\nformations.  This works on top of any endianess you specify with\n",
                    "long": "--byteswap"
                },
                {
                    "name": "-m --mono",
                    "content": "Set for single-channel audio (default is two channels, stereo).\n",
                    "flag": "-m",
                    "long": "--mono"
                },
                {
                    "name": "--stereo",
                    "content": "Select stereo output (2 channels, default).\n",
                    "long": "--stereo"
                },
                {
                    "name": "--list-encodings",
                    "content": "List known encoding short and long names to standard output.\n\n--mix matrix\nSpecify  a  mixing  matrix  between input and output channels as linear factors, comma\nseparated list for the input channel factors for output channel 1, then output channel\n2, and so forth.  The default is a unit matrix if channel counts match, so for 3 chan‐\nnels the equivalent of both channels with halved amplitude, so  '--mix  0.5,0.5'.  For\nsplitting mono to stereo, it is '--mix 1,1' top keep the symmetry.\n\n--filter coeff\nApply  digital  filter(s) before pre-amplification (see --preamp) with the coefficient\nlist coeff as\nb0,...,bN,a0,...,aN\nwhere a0=1 is mandatory and perhaps helps orientation a  bit.  Multiple  filters  are\nseparated by ':'.\n",
                    "long": "--list-encodings"
                },
                {
                    "name": "-P --preamp",
                    "content": "Enable  a pre-amplification stage that amplifies the signal with the given value in dB\nbefore output.\n\n--offset value\nApply a PCM offset (floating point value scaled in  [-1:1]  in  the  pre-amplification\nstage.  Normally, you would do that to correct a known DC offset in a recording.\n\n--clip mode\nSelect  clipping  mode:  'soft'  or 'hard' for forced clipping also for floating point\noutput, 'implicit' (default) for implied hard clipping during conversion where  neces‐\nsary.\n",
                    "flag": "-P",
                    "long": "--preamp"
                },
                {
                    "name": "--dither",
                    "content": "Enable  dithering  for  conversions  to integer. If you insist.  This is just some un-\nspectacular TPDF dither. For some people, that is not fancy enough.  Most people  can‐\nnot be bothered that way or the other.\n",
                    "long": "--dither"
                },
                {
                    "name": "--test-format",
                    "content": "Check  if given format is supported by given driver and device (in command line before\nencountering this), silently returning 0 as exit value if it is the case.\n",
                    "long": "--test-format"
                },
                {
                    "name": "--test-encodings",
                    "content": "Print out the short names of encodings supported with the current setup.\n",
                    "long": "--test-encodings"
                },
                {
                    "name": "--query-format",
                    "content": "If the selected driver and device communicate some default accepted format, print  out\na  command  line fragment for out123 setting that format, always in that order: --rate\n<r> --channels <c> --encoding <e>\n",
                    "long": "--query-format"
                },
                {
                    "name": "-o --headphones",
                    "content": "Direct audio output to the headphone connector (some hardware only; AIX, HP, SUN).\n",
                    "flag": "-o",
                    "long": "--headphones"
                },
                {
                    "name": "-o --speaker",
                    "content": "Direct audio output to the speaker  (some hardware only; AIX, HP, SUN).\n",
                    "flag": "-o",
                    "long": "--speaker"
                },
                {
                    "name": "-o --lineout",
                    "content": "Direct audio output to the line-out connector (some hardware only; AIX, HP, SUN).\n",
                    "flag": "-o",
                    "long": "--lineout"
                },
                {
                    "name": "-b --buffer",
                    "content": "Use an audio output buffer of size Kbytes.  This is useful to bypass short periods  of\nheavy  system activity, which would normally cause the audio output to be interrupted.\nYou should specify a buffer size of at least 1024 (i.e. 1 Mb,  which  equals  about  6\nseconds  of  usual  audio data) or more; less than about 300 does not make much sense.\nThe default is 0, which turns buffering off.\n\n--preload fraction\nWait for the buffer to be filled to fraction before starting  playback  (fraction  be‐\ntween 0 and 1). You can tune this prebuffering to either get sound faster to your ears\nor safer uninterrupted web radio.  Default is 0.2 (changed from 1 since version 1.23).\n\n--devbuffer seconds\nSet device buffer in seconds; <= 0 means default value. This is the small  buffer  be‐\ntween  the  application  and  the audio backend, possibly directly related to hardware\nbuffers.\n\n--timelimit samples\nSet playback time limit in PCM samples if set to a value greater  than  zero.   out123\nwill  stop  reading from stdin or playing from the generated wave table after reaching\nthat number of samples.\n\n--seconds seconds\nSet time limit in seconds instead.\n\n--source name\nChoose the signal source: 'file' (default) for playback of the given  file(s)  on  the\ncommand line or standard input if there are none, or one of the generators 'wave' (see\n--wave-freq), geiger (see --geiger-activity), or just 'white' for some white noise.\n\n--wave-freq frequencies\nSet wave generator frequency or list of those with comma  separation  for  enabling  a\ngenerated test signal instead of standard input. Empty values repeat the previous one.\n\n--wave-pat patterns\nSet the waveform patterns of the generated waves as comma-separated list.  Choices in‐\nclude sine, square, triangle, sawtooth, gauss, pulse, and shot.  Empty  values  repeat\nthe previous one.\n\n--wave-phase phases\nSet  waveform  phase  shift(s)  as comma-separated list, negative values inverting the\npattern in time and empty value repeating the previous. There is also --wave-direction\noverriding the negative bit.\n",
                    "flag": "-b",
                    "long": "--buffer"
                },
                {
                    "name": "--wave-direction",
                    "content": "Set wave direction explicitly (the sign counts).\n\n--wave-sweep frequency\nSweep  a  generated  wave  to  the  given  frequency,  from  first  one  specified for\n--wave-freq, using the first wave pattern and direction, too.\n\n--sweep-time seconds\nSet frequency sweep duration in seconds if > 0. This defaults to the  configured  time\nlimit if set, otherwise one second, as endless sweeps are not sensible.\n\n--sweep-count count\nSet timelimit to exactly produce that many (smooth) sweeps\n\n--sweep-type type\nSet  sweep type: lin(ear) for linear, qua(d) (default) for quadratic, or exp(onential)\nfor an exponential change of frequency with time.\n",
                    "long": "--wave-direction"
                },
                {
                    "name": "--sweep-hard",
                    "content": "Disable post-sweep smoothing for periodicity.\n\n--genbuffer bytes\nSet the buffer size (limit) for signal generators, if > 0 (default), this  enforces  a\nperiodic  buffer also for non-periodic signals, benefit: less runtime CPU overhead, as\neverything is precomputed as enforced periodic signal.\n\n--wave-limit samples\nThis is an alias for --genbuffer.\n\n--pink-rows number\nActivate pink noise source and choose rows for the  algorithm  (<1  chooses  default).\nThe  generator  follows code provided by Phil Burk (http://softsynth.com) and uses the\nGardner method.\n\n--geiger-activity number\nThis configures the simulation of a Geiger-Mueller counter as source, with  the  given\nnumer as average events per second. Play with it. It's fun!\n",
                    "long": "--sweep-hard"
                },
                {
                    "name": "-t --test",
                    "content": "Test mode.  The audio stream is read, but no output occurs.\n",
                    "flag": "-t",
                    "long": "--test"
                },
                {
                    "name": "-v --verbose",
                    "content": "Increase the verbosity level.\n",
                    "flag": "-v",
                    "long": "--verbose"
                },
                {
                    "name": "-q --quiet",
                    "content": "Quiet.  Suppress diagnostic messages.\n",
                    "flag": "-q",
                    "long": "--quiet"
                },
                {
                    "name": "--aggressive",
                    "content": "Tries to get higher priority\n",
                    "long": "--aggressive"
                },
                {
                    "name": "-T --realtime",
                    "content": "Tries to gain realtime priority.  This option usually requires root privileges to have\nany effect.\n\n-?, --help\nShows short usage instructions.\n",
                    "flag": "-T",
                    "long": "--realtime"
                },
                {
                    "name": "--longhelp",
                    "content": "Shows long usage instructions.\n",
                    "long": "--longhelp"
                },
                {
                    "name": "--version",
                    "content": "Print the version string.\n",
                    "long": "--version"
                }
            ]
        },
        "AUTHORS": {
            "content": "Maintainer:\nThomas Orgis <maintainer@mpg123.org>, <thomas@orgis.org>\n\nCreator (ancestry of code inside mpg123):\nMichael Hipp\n\nUses code or ideas from various people, see the AUTHORS file accompanying the source code.\n",
            "subsections": []
        },
        "LICENSE": {
            "content": "out123 is licensed under the GNU Lesser/Library General Public License, LGPL, version 2.1 .\n",
            "subsections": []
        },
        "WEBSITE": {
            "content": "http://www.mpg123.org\nhttp://sourceforge.net/projects/mpg123\n\n\n\n26 Apr 2020                                   out123(1)",
            "subsections": []
        }
    },
    "summary": "out123 - send raw PCM audio or a waveform pattern to an output device",
    "flags": [
        {
            "flag": "-o",
            "long": null,
            "arg": null,
            "description": "Select audio output module. You can provide a comma-separated list to use the first one that works. Also see -a."
        },
        {
            "flag": "",
            "long": "--list-modules",
            "arg": null,
            "description": "List the available modules."
        },
        {
            "flag": "",
            "long": "--list-devices",
            "arg": null,
            "description": "List the available output devices for given output module. If there is no functional‐ ity to list devices in the chosen module, an error will be printed and out123 will exit with a non-zero code."
        },
        {
            "flag": "-a",
            "long": "--audiodevice",
            "arg": null,
            "description": "Specify the audio device to use. The default as well as the possible values depend on the active output. For the JACK output, a comma-separated list of ports to connect to (for each channel) can be specified."
        },
        {
            "flag": "-s",
            "long": "--stdout",
            "arg": null,
            "description": "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 similar the standard tool cat, possibly with some conversions involved. This shortcut is equivalent to '-o raw -a -'."
        },
        {
            "flag": "-S",
            "long": "--STDOUT",
            "arg": null,
            "description": "This variant additionally writes the data to stdout, while still playing it on the output device. So it is more like some flavour of tee than a cat."
        },
        {
            "flag": "-O",
            "long": "--outfile",
            "arg": null,
            "description": "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'."
        },
        {
            "flag": "-w",
            "long": "--wav",
            "arg": null,
            "description": "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 Au‐ dio). 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'."
        },
        {
            "flag": "-r",
            "long": "--rate",
            "arg": null,
            "description": "Set sample rate in Hz (default: 44100). If this does not match the actual input sam‐ pling rate, you get changed pitch. Might be intentional;-)"
        },
        {
            "flag": "-R",
            "long": "--inputrate",
            "arg": null,
            "description": "Set input sample rate to a different value. This triggers resampling if the output rate is indeed different. See --resample. --speed factor Speed up/down playback by that factor using resampling. See --resample. --resample method This chooses the method for resampling between differing sampling rates or to apply a change in tempo. You can choose between two variants of the syn123 resampler: fine (the default) and dirty. The fine one features 108 dB dynamic range and at worst-case 84% bandwidth. The dirty one uses a bit less CPU time (not that much, though) by re‐ ducing the dynamic range to 72 dB with worst-case bandwidth of 85%. The exact proper‐ ties vary with the sampling rate ratio, as there is interpolation of filter coeffi‐ cients involved."
        },
        {
            "flag": "-c",
            "long": "--channels",
            "arg": null,
            "description": "Set channel count to given value."
        },
        {
            "flag": "-C",
            "long": "--inputch",
            "arg": null,
            "description": "Set input channel count to a differnt value than for output. This probably means you want some remixing. Also see --mix."
        },
        {
            "flag": "-e",
            "long": "--encoding",
            "arg": null,
            "description": "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 dif‐ ferent 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 en‐ codings. Default is s16. --endian choice Select output endianess (byte order). Choice is big, little, or native, which is the default. The processing can only work in native mode, so you need to specify input or output byte order if that does not match your machine. This also sets the input endi‐ aness if that is not set separately. See also --inputend and --byteswap."
        },
        {
            "flag": "-E",
            "long": "--inputenc",
            "arg": null,
            "description": "Specify input encoding different from output encoding for conversion. --inputend choice Select input endianess (byte order). By default it is the same as output byte order. See --endian."
        },
        {
            "flag": "",
            "long": "--byteswap",
            "arg": null,
            "description": "A switch to trigger swapping of byte order just before output, after any other trans‐ formations. This works on top of any endianess you specify with"
        },
        {
            "flag": "-m",
            "long": "--mono",
            "arg": null,
            "description": "Set for single-channel audio (default is two channels, stereo)."
        },
        {
            "flag": "",
            "long": "--stereo",
            "arg": null,
            "description": "Select stereo output (2 channels, default)."
        },
        {
            "flag": "",
            "long": "--list-encodings",
            "arg": null,
            "description": "List known encoding short and long names to standard output. --mix matrix Specify a mixing matrix between input and output channels as linear factors, comma separated list for the input channel factors for output channel 1, then output channel 2, and so forth. The default is a unit matrix if channel counts match, so for 3 chan‐ nels the equivalent of both channels with halved amplitude, so '--mix 0.5,0.5'. For splitting mono to stereo, it is '--mix 1,1' top keep the symmetry. --filter coeff Apply digital filter(s) before pre-amplification (see --preamp) with the coefficient list coeff as b0,...,bN,a0,...,aN where a0=1 is mandatory and perhaps helps orientation a bit. Multiple filters are separated by ':'."
        },
        {
            "flag": "-P",
            "long": "--preamp",
            "arg": null,
            "description": "Enable a pre-amplification stage that amplifies the signal with the given value in dB before output. --offset value Apply a PCM offset (floating point value scaled in [-1:1] in the pre-amplification stage. Normally, you would do that to correct a known DC offset in a recording. --clip mode Select clipping mode: 'soft' or 'hard' for forced clipping also for floating point output, 'implicit' (default) for implied hard clipping during conversion where neces‐ sary."
        },
        {
            "flag": "",
            "long": "--dither",
            "arg": null,
            "description": "Enable dithering for conversions to integer. If you insist. This is just some un- spectacular TPDF dither. For some people, that is not fancy enough. Most people can‐ not be bothered that way or the other."
        },
        {
            "flag": "",
            "long": "--test-format",
            "arg": null,
            "description": "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."
        },
        {
            "flag": "",
            "long": "--test-encodings",
            "arg": null,
            "description": "Print out the short names of encodings supported with the current setup."
        },
        {
            "flag": "",
            "long": "--query-format",
            "arg": null,
            "description": "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>"
        },
        {
            "flag": "-o",
            "long": "--headphones",
            "arg": null,
            "description": "Direct audio output to the headphone connector (some hardware only; AIX, HP, SUN)."
        },
        {
            "flag": "-o",
            "long": "--speaker",
            "arg": null,
            "description": "Direct audio output to the speaker (some hardware only; AIX, HP, SUN)."
        },
        {
            "flag": "-o",
            "long": "--lineout",
            "arg": null,
            "description": "Direct audio output to the line-out connector (some hardware only; AIX, HP, SUN)."
        },
        {
            "flag": "-b",
            "long": "--buffer",
            "arg": null,
            "description": "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 be‐ tween 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 be‐ tween the application and the audio backend, possibly directly related to hardware buffers. --timelimit samples Set playback time limit in PCM samples if set to a value greater than zero. out123 will stop reading from stdin or playing from the generated wave table after reaching that number of samples. --seconds seconds Set time limit in seconds instead. --source name Choose the signal source: 'file' (default) for playback of the given file(s) on the command line or standard input if there are none, or one of the generators 'wave' (see --wave-freq), geiger (see --geiger-activity), or just 'white' for some white noise. --wave-freq frequencies Set wave generator frequency or list of those with comma separation for enabling a generated test signal instead of standard input. Empty values repeat the previous one. --wave-pat patterns Set the waveform patterns of the generated waves as comma-separated list. Choices in‐ clude sine, square, triangle, sawtooth, gauss, pulse, and shot. Empty values repeat the previous one. --wave-phase phases Set waveform phase shift(s) as comma-separated list, negative values inverting the pattern in time and empty value repeating the previous. There is also --wave-direction overriding the negative bit."
        },
        {
            "flag": "",
            "long": "--wave-direction",
            "arg": null,
            "description": "Set wave direction explicitly (the sign counts). --wave-sweep frequency Sweep a generated wave to the given frequency, from first one specified for --wave-freq, using the first wave pattern and direction, too. --sweep-time seconds Set frequency sweep duration in seconds if > 0. This defaults to the configured time limit if set, otherwise one second, as endless sweeps are not sensible. --sweep-count count Set timelimit to exactly produce that many (smooth) sweeps --sweep-type type Set sweep type: lin(ear) for linear, qua(d) (default) for quadratic, or exp(onential) for an exponential change of frequency with time."
        },
        {
            "flag": "",
            "long": "--sweep-hard",
            "arg": null,
            "description": "Disable post-sweep smoothing for periodicity. --genbuffer bytes Set the buffer size (limit) for signal generators, if > 0 (default), this enforces a periodic buffer also for non-periodic signals, benefit: less runtime CPU overhead, as everything is precomputed as enforced periodic signal. --wave-limit samples This is an alias for --genbuffer. --pink-rows number Activate pink noise source and choose rows for the algorithm (<1 chooses default). The generator follows code provided by Phil Burk (http://softsynth.com) and uses the Gardner method. --geiger-activity number This configures the simulation of a Geiger-Mueller counter as source, with the given numer as average events per second. Play with it. It's fun!"
        },
        {
            "flag": "-t",
            "long": "--test",
            "arg": null,
            "description": "Test mode. The audio stream is read, but no output occurs."
        },
        {
            "flag": "-v",
            "long": "--verbose",
            "arg": null,
            "description": "Increase the verbosity level."
        },
        {
            "flag": "-q",
            "long": "--quiet",
            "arg": null,
            "description": "Quiet. Suppress diagnostic messages."
        },
        {
            "flag": "",
            "long": "--aggressive",
            "arg": null,
            "description": "Tries to get higher priority"
        },
        {
            "flag": "-T",
            "long": "--realtime",
            "arg": null,
            "description": "Tries to gain realtime priority. This option usually requires root privileges to have any effect. -?, --help Shows short usage instructions."
        },
        {
            "flag": "",
            "long": "--longhelp",
            "arg": null,
            "description": "Shows long usage instructions."
        },
        {
            "flag": "",
            "long": "--version",
            "arg": null,
            "description": "Print the version string."
        }
    ],
    "examples": [],
    "see_also": []
}