|pw-cat(1)||General Commands Manual||pw-cat(1)|
pw-cat - Play and record media with PipeWire
pw-cat [options] [FILE | -]
pw-play [options] [FILE | -]
pw-record [options] [FILE | -]
pw-midiplay [options] [FILE | -]
pw-midirecord [options] [FILE | -]
pw-dsdplay [options] [FILE | -]
pw-cat is a simple tool for playing back or capturing raw or encoded media files on a PipeWire server. It understands all audio file formats supported by libsndfile for PCM capture and playback. When capturing PCM, the filename extension is used to guess the file format with the WAV file format as the default.
It understands standard MIDI files for playback and recording. This tool will not render MIDI files, it will simply make the MIDI events available to the graph. You need a MIDI renderer such as qsynth, timidity or a hardware MIDI rendered to hear the MIDI.
DSD playback is supported with the DSF file format. This tool will only work with native DSD capable hardware and will produce an error when no such hardware was found.
When the FILE is - input and output will be raw data from STDIN and STDOUT respectively.
-h | --help
-v | --verbose
-R | --remote=NAME
-p | --playback
-r | --record
-m | --midi
-d | --dsd
- auto: Automatically select (Default)
- 0: Don't try to link this node
- <id>: The object.serial or the node.name of a target node
The latency determines the minimum amount of time it takes for a sample to travel from application to device (playback) and from device to application (capture).
The latency determines the size of the buffers that the application will be able to fill. Lower latency means smaller buffers but higher overhead. Higher latency means larger buffers and lower overhead.
Units can be s for seconds, ms for milliseconds, us for microseconds, ns for nanoseconds. If no units are given, the latency value is samples with the samplerate of the file.
-P | --properties=VALUE
-q | --quality=VALUE
The PipeWire Developers https://gitlab.freedesktop.org/pipewire/pipewire/issues; PipeWire is available from https://pipewire.org