From 682544fc1ac6ff9eb849510c4369831434437482 Mon Sep 17 00:00:00 2001
From: Managor <42655600+Managor@users.noreply.github.com>
Date: Tue, 28 Sep 2021 14:53:19 +0300
Subject: [PATCH] pw-cat, pw-play, pw-record: add page (#6602)

---
 pages/linux/pw-cat.md    | 24 ++++++++++++++++++++++++
 pages/linux/pw-play.md   | 16 ++++++++++++++++
 pages/linux/pw-record.md | 20 ++++++++++++++++++++
 3 files changed, 60 insertions(+)
 create mode 100644 pages/linux/pw-cat.md
 create mode 100644 pages/linux/pw-play.md
 create mode 100644 pages/linux/pw-record.md

diff --git a/pages/linux/pw-cat.md b/pages/linux/pw-cat.md
new file mode 100644
index 000000000..d77e3a1a7
--- /dev/null
+++ b/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}}`
diff --git a/pages/linux/pw-play.md b/pages/linux/pw-play.md
new file mode 100644
index 000000000..51733bf88
--- /dev/null
+++ b/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}}`
diff --git a/pages/linux/pw-record.md b/pages/linux/pw-record.md
new file mode 100644
index 000000000..09aa904c1
--- /dev/null
+++ b/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}}`