1PW-CAT(1)                   General Commands Manual                  PW-CAT(1)
2
3
4

NAME

6       pw-cat - Play and record media with PipeWire
7

SYNOPSIS

9       pw-cat [options] [FILE]
10       pw-play [options] [FILE]
11       pw-record [options] [FILE]
12       pw-midiplay [options] [FILE]
13       pw-midirecord [options] [FILE]
14
15

DESCRIPTION

17       pw-cat  is  a  simple tool for playing back or capturing raw or encoded
18       media files on a PipeWire server. It understands all audio file formats
19       supported by libsndfile.
20

OPTIONS

22       -h | --help
23              Show help.
24
25       --version
26              Show version information.
27
28       -v | --verbose
29              Verbose operation.
30
31       -R | --remote=NAME
32              The name the remote instance to connect to. If left unspecified,
33              a connection is made to the default PipeWire instance.
34
35       -p | --playback
36              Playback mode. Read data from the specified file,  and  play  it
37              back.   If  the  tool  is  called  under  the  name  pw-play  or
38              pw-midiplay this is the default.
39
40       -r | --record
41              Recording mode. Capture data and write it to the specified file.
42              If  the tool is called under the name pw-record or pw-midirecord
43              this is the default.
44
45       -m | --midi
46              MIDI mode. FILE is a MIDI file. If the tool is called under  the
47              name pw-midiplay or pw-midirecord this is the default.
48
49       --media-type=VALUE
50              Set  the  media  type  property (default Audio/Midi depending on
51              mode).  The media type is used by the session manager to  select
52              a suitable target to link to.
53
54       --media-category=VALUE
55              Set  the  media  category property (default Playback/Capture de‐
56              pending on mode).  The media type is used by the session manager
57              to select a suitable target to link to.
58
59       --media-role=VALUE
60              Set  the media role property (default Music).  The media type is
61              used by the session manager to select a suitable target to  link
62              to.
63
64       --target=VALUE
65              Set a node target (default auto). The value can be:
66
67              auto   Automatically select (Default)
68
69              0      Don't try to link this node
70
71              <id>   The id of a target node
72
73       --latency=VALUE[units]
74              Set the node latency (default 100ms)
75
76              The latency determines the minimum amount of time it takes for a
77              sample to travel from application to device (playback) and  from
78              device to application (capture).
79
80              The latency determines the size of the buffers that the applica‐
81              tion will be able to fill. Lower latency means  smaller  buffers
82              but  higher  overhead.  Higher  latency means larger buffers and
83              lower overhead.
84
85              Units can be s for seconds, ms  for  milliseconds,  us  for  mi‐
86              croseconds,  ns for nanoseconds.  If no units are given, the la‐
87              tency value is samples with the samplerate of the file.
88
89       --list-targets
90              List the available targets for --target
91
92       -q | --quality=VALUE
93              Resampler quality. When the samplerate of the source or destina‐
94              tion  file does not match the samplerate of the server, the data
95              will be resampled. Higher quality uses more CPU. Values  between
96              0 and 15 are allowed, the default quality is 4.
97
98       --rate=VALUE
99              The sample rate, default 48000.
100
101       --channels=VALUE
102              The number of channels, default 2.
103
104       --channel-map=VALUE
105              The  channelmap.  Possible  values  include:  mono, stereo, sur‐
106              round-21,  quad,  surround-22,  surround-40,  surround-31,  sur‐
107              round-41,  surround-50,  surround-51, surround-51r, surround-70,
108              surround-71 or a comma separated list of channel names: FL,  FR,
109              FC,  LFE,  SL, SR, FLC, FRC, RC, RL, RR, TC, TFL, TFC, TFR, TRL,
110              TRC, TRR, RLC, RRC, FLW, FRW, LFE2, FLH, FCH, FRH,  TFLC,  TFRC,
111              TSL, TSR, LLFR, RLFE, BC, BLC, BRC
112
113       --format=VALUE
114              The  sample  format to use. One of: s8, s16 (default), s24, s32,
115              f32, f64.
116
117       --volume=VALUE
118              The stream volume, default 1.000.
119

AUTHORS

121       The                PipeWire                Developers                <‐
122       https://gitlab.freedesktop.org/pipewire/pipewire/issues>;  PipeWire  is
123       available from https://pipewire.org
124

SEE ALSO

126       PipeWire(1), pw-mon(1),
127
128
129
130
131                                                                     PW-CAT(1)
Impressum