$linuxjunkies
>

pw-play(1)

Play audio files or streams using PipeWire audio server.

UbuntuDebianFedoraArch

Synopsis

pw-play [OPTION]... [FILE]...

Description

pw-play is a simple command-line audio player for PipeWire, the modern audio server for Linux. It can play local audio files or stream audio from various sources, automatically detecting the format and routing through PipeWire's flexible audio graph.

The player supports common audio formats including WAV, FLAC, MP3, OGG, and others. It can connect to any PipeWire sink and provides basic playback control options from the command line.

Common options

FlagWhat it does
-h, --helpShow help message and exit
-v, --verboseEnable verbose output for debugging
--volume=VOLUMESet playback volume (0.0 to 1.0, default 0.7)
-p, --playbackForce playback mode (default)
-R, --remote=NAMEConnect to specific PipeWire remote instance
--rate=RATESet sample rate in Hz
--channels=CHANNELSSet number of audio channels
-q, --quietSuppress normal output messages

Examples

Play a WAV file through the default PipeWire sink

pw-play song.wav

Play a FLAC file at 50% volume

pw-play --volume=0.5 music.flac

Play multiple audio files sequentially

pw-play file1.mp3 file2.mp3 file3.mp3

Play an OGG file with verbose debugging output

pw-play -v song.ogg 2>&1

Play audio file at 48 kHz sample rate

pw-play --rate=48000 audio.wav

Related commands