pw-cat, pw-play, pw-record: add page (#6602)

pages/linux/pw-cat.md

@@ -0,0 +1,24 @@
+# pw-cat
+
+> Pipewire tool for playing and recording audio files.
+> More information: <https://fedoraproject.org/wiki/QA:Testcase_PipeWire_PipeWire_CLI>.
+
+- List all available playback targets:
+
+`pw-cat --playback --list-targets`
+
+- Play a WAV file over the default target:
+
+`pw-cat --playback {{path/to/file.wav}}`
+
+- List all available record targets:
+
+`pw-cat --record --list-targets`
+
+- Record a sample recording at a different volume level:
+
+`pw-cat --record --volume={{0.1}} {{path/to/file.wav}}`
+
+- Record a sample recording using a different sample rate:
+
+`pw-cat --record --rate={{6000}} {{path/to/file.wav}}`

pages/linux/pw-play.md

@@ -0,0 +1,16 @@
+# pw-play
+
+> Shorthand tool for pw-cat --playback.
+> More information: <https://fedoraproject.org/wiki/QA:Testcase_PipeWire_PipeWire_CLI>.
+
+- List all available playback targets:
+
+`pw-play --list-targets`
+
+- Play a wav sound file over the default target:
+
+`pw-play {{path/to/file.wav}}`
+
+- Play a wav sound file at a different volume level:
+
+`pw-play --volume={{0.1}} {{path/to/file.wav}}`

pages/linux/pw-record.md

@@ -0,0 +1,20 @@
+# pw-record
+
+> Shorthand tool for pw-cat --playback.
+> More information: <https://fedoraproject.org/wiki/QA:Testcase_PipeWire_PipeWire_CLI>.
+
+- List all available record targets:
+
+`pw-record --list-targets`
+
+- Record a sample recording using the default target:
+
+`pw-record {{path/to/file.wav}}`
+
+- Record a sample recording at a different volume level:
+
+`pw-record --volume={{0.1}} {{path/to/file.wav}}`
+
+- Record a sample recording using a different sample rate:
+
+`pw-record --rate={{6000}} {{path/to/file.wav}}`