OS Manuals

/usr/bin/pacat

From pulseaudio-utils 17.0-r13 (os), captured 2026-11-05 by running pacat --help (exit 0). permalink

pacat [options]
Play back audio data from STDIN or the specified file on a PulseAudio sound server.

  -h, --help                            Show this help
      --version                         Show version

  -r, --record                          Create a connection for recording
  -p, --playback                        Create a connection for playback

  -v, --verbose                         Enable verbose operations

  -s, --server=SERVER                   The name of the server to connect to
  -d, --device=DEVICE                   The name of the sink/source to connect to. The special names @DEFAULT_SINK@, @DEFAULT_SOURCE@ and @DEFAULT_MONITOR@ can be used to specify the default sink, source and monitor respectively.
  -n, --client-name=NAME                How to call this client on the server
      --stream-name=NAME                How to call this stream on the server
      --volume=VOLUME                   Specify the initial (linear) volume in range 0...65536
      --rate=SAMPLERATE                 The sample rate in Hz (defaults to 44100)
      --format=SAMPLEFORMAT             The sample format, see
                                        https://www.freedesktop.org/wiki/Software/PulseAudio/Documentation/User/SupportedAudioFormats/
                                        for possible values (defaults to s16ne)
      --channels=CHANNELS               The number of channels, 1 for mono, 2 for stereo
                                        (defaults to 2)
      --channel-map=CHANNELMAP          Channel map to use instead of the default
      --fix-format                      Take the sample format from the sink/source the stream is
                                        being connected to.
      --fix-rate                        Take the sampling rate from the sink/source the stream is
                                        being connected to.
      --fix-channels                    Take the number of channels and the channel map
                                        from the sink/source the stream is being connected to.
      --no-remix                        Don't upmix or downmix channels.
      --no-remap                        Map channels by index instead of name.
      --latency=BYTES                   Request the specified latency in bytes.
      --process-time=BYTES              Request the specified process time per request in bytes.
      --latency-msec=MSEC               Request the specified latency in msec.
      --process-time-msec=MSEC          Request the specified process time per request in msec.
      --property=PROPERTY=VALUE         Set the specified property to the specified value.
      --raw                             Record/play raw PCM data.
      --passthrough                     Passthrough data.
      --file-format[=FFORMAT]           Record/play formatted PCM data.
      --list-file-formats               List available file formats.
      --monitor-stream=INDEX            Record from the sink input with index INDEX.
Options (29)
OptionDescriptionSource
-h, --helpShow this helphelp + man
--versionShow version information.help + man
-r, --recordCapture audio data and write it to the specified file or to STDOUT if none is specified.help + man
-p, --playbackRead audio data from the specified file or STDIN if none is specified, and play it back.help + man
-v, --verboseEnable verbose operationshelp + man
-s, --server SERVERThe name of the server to connect tohelp + man
-d, --device DEVICESpecify the symbolic name of the sink/source to play/record this stream on/from.help + man
-n, --client-name NAMESpecify the client name paplay shall pass to the server when connecting.help + man
--stream-name NAMESpecify the stream name paplay shall pass to the server when creating the stream.help + man
--volume VOLUMESpecify the initial (linear) volume in range 0...65536help + man
--rate SAMPLERATECapture or play back audio with the specified sample rate.help + man
--format SAMPLEFORMATThe sample format, see https://www.freedesktop.org/wiki/Software/PulseAudio/Documentation/User/SupportedAudioFormats/ for possible values (defaults to s16ne)help + man
--channels CHANNELSCapture or play back audio with the specified number of channels.help + man
--channel-map CHANNELMAPExplicitly choose a channel map when playing back this stream.help + man
--fix-formatIf passed, the sample format of the stream is changed to the native format of the sink the stream is connected to.help + man
--fix-rateIf passed, the sampling rate of the stream is changed to the native rate of the sink the stream is connected to.help + man
--fix-channelsIf passed, the number of channels and the channel map of the stream is changed to the native number of channels and the native channel map of the sink the stream is connected to.help + man
--no-remixDon't upmix or downmix channels.help + man
--no-remapMap channels by index instead of name.help + man
--latency BYTESExplicitly configure the latency, with a time specified in bytes in the selected sample format.help + man
--process-time BYTESExplicitly configure the process time, with a time specified in bytes in the selected sample format.help + man
--latency-msec MSECExplicitly configure the latency, with a time specified in milliseconds.help + man
--process-time-msec MSECExplicitly configure the process time, with a time specified in milliseconds.help + man
--property PROPERTY=VALUESet the specified property to the specified value.help + man
--rawPlay/record raw audio data.help + man
--passthroughPassthrough data.help
--file-format FFORMATRecord/play formatted PCM data.help
--list-file-formatsList available file formats.help + man
--monitor-stream INDEXRecord from the sink input with index INDEX.help + man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.