← 返回命令列表

Linux command

pw-encplay 命令

文件

复制后可按需替换文件名、目录或参数。

常用示例

Play an encoded audio file

pw-encplay [path/to/file]

Play with a specific volume

pw-encplay --volume [0.8] [path/to/file]

Play to a specific target node

pw-encplay --target [node_id] [path/to/file]

Play with verbose output

pw-encplay -v [path/to/file]

说明

pw-encplay plays encoded (compressed) audio streams through a PipeWire server. It is a convenience wrapper for pw-cat in encoded playback mode, passing encoded audio data directly to the PipeWire graph without decoding it first. This enables passthrough of compressed audio formats (such as AC3, DTS, or AAC) to hardware decoders or receivers that support native decoding, preserving the original encoded stream quality. When - is given as the file, data is read from stdin.

参数

--volume _level_
Stream volume (default 1.0).
--rate _hz_
Sample rate in Hz (default 48000).
--channels _num_
Number of audio channels (default 2).
--channel-map _map_
Channel layout (e.g. stereo, surround-51, or custom FL,FR mapping).
--format _fmt_
Sample format: u8, s8, s16, s24, s32, f32, f64 (default s16).
--target _value_
Target node: auto, 0, or a specific node ID.
--latency _value_
Node latency (default 100ms).
-q, --quality _level_
Resampler quality (0-15, default 4).
-R, --remote _name_
Connect to a specific PipeWire instance.
-P, --properties _json_
Extra stream properties as a JSON object.
-v, --verbose
Enable verbose output.
-h, --help
Display help information.
--version
Show version details.

FAQ

What is the pw-encplay command used for?

pw-encplay plays encoded (compressed) audio streams through a PipeWire server. It is a convenience wrapper for pw-cat in encoded playback mode, passing encoded audio data directly to the PipeWire graph without decoding it first. This enables passthrough of compressed audio formats (such as AC3, DTS, or AAC) to hardware decoders or receivers that support native decoding, preserving the original encoded stream quality. When - is given as the file, data is read from stdin.

How do I run a basic pw-encplay example?

Run `pw-encplay [path/to/file]` in a terminal, then adjust file names, paths, flags, or remote targets for your system.

What does --volume _level_ do in pw-encplay?

Stream volume (default 1.0).