2025-03-14 21:59:59 -06:00
|
|
|
# pw-cat
|
|
|
|
|
|
|
|
|
|
> Play and record audio files through PipeWire.
|
2025-07-24 22:27:13 -06:00
|
|
|
> See also: `wpctl`, `pw-cli`.
|
2025-03-14 21:59:59 -06:00
|
|
|
> More information: <https://docs.pipewire.org/page_man_pw-cat_1.html>.
|
|
|
|
|
|
|
|
|
|
- Play a WAV file over the default target:
|
|
|
|
|
|
2025-05-08 12:26:01 -06:00
|
|
|
`pw-cat {{[-p|--playback]}} {{path/to/file.wav}}`
|
2025-03-14 21:59:59 -06:00
|
|
|
|
2026-06-12 17:51:25 -06:00
|
|
|
- Play a MIDI file:
|
|
|
|
|
|
|
|
|
|
`pw-cat {{[-p|--playback]}} {{[-m|--midi]}} {{path/to/file.mid}}`
|
|
|
|
|
|
|
|
|
|
- Play a DSD file:
|
|
|
|
|
|
|
|
|
|
`pw-cat {{[-p|--playback]}} {{[-d|--dsd]}} {{path/to/file.dsf}}`
|
|
|
|
|
|
|
|
|
|
- Play a compressed audio file using passthrough (requires FFmpeg integration):
|
|
|
|
|
|
|
|
|
|
`pw-cat {{[-p|--playback]}} {{[-o|--encoded]}} {{path/to/file.ac3}}`
|
|
|
|
|
|
2025-03-14 21:59:59 -06:00
|
|
|
- Play a WAV file with a specified resampler quality (4 by default):
|
|
|
|
|
|
2026-06-12 17:51:25 -06:00
|
|
|
`pw-cat {{[-p|--playback]}} {{[-q|--quality]}} {{0..15}} {{path/to/file.wav}}`
|
|
|
|
|
|
|
|
|
|
- Record a MIDI file:
|
|
|
|
|
|
|
|
|
|
`pw-cat {{[-r|--record]}} {{[-m|--midi]}} {{path/to/file.mid}}`
|
2025-03-14 21:59:59 -06:00
|
|
|
|
|
|
|
|
- Record a sample recording at a volume level of 125%:
|
|
|
|
|
|
2025-05-08 12:26:01 -06:00
|
|
|
`pw-cat {{[-r|--record]}} --volume {{1.25}} {{path/to/file.wav}}`
|
2025-03-14 21:59:59 -06:00
|
|
|
|
|
|
|
|
- Record a sample recording using a different sample rate:
|
|
|
|
|
|
2025-05-08 12:26:01 -06:00
|
|
|
`pw-cat {{[-r|--record]}} --rate {{6000}} {{path/to/file.wav}}`
|