From 62f69581bf3a5fde15b9e7722cd9973d627a5401 Mon Sep 17 00:00:00 2001
From: Pauli Virtanen <pav@iki.fi>
Date: Sat, 18 Nov 2023 18:05:10 +0200
Subject: [PATCH] man: add pw-loopback.1

---
 man/meson.build          |  1 +
 man/pw-loopback.1.rst.in | 79 ++++++++++++++++++++++++++++++++++++++++
 2 files changed, 80 insertions(+)
 create mode 100644 man/pw-loopback.1.rst.in

diff --git a/man/meson.build b/man/meson.build
index 071802ab1..a1fddb05b 100644
--- a/man/meson.build
+++ b/man/meson.build
@@ -16,6 +16,7 @@ manpages = [
   'pw-dot.1.rst.in',
   'pw-dump.1.rst.in',
   'pw-link.1.rst.in',
+  'pw-loopback.1.rst.in',
   'pw-metadata.1.rst.in',
   'pw-mididump.1.rst.in',
   'pw-mon.1.rst.in',
diff --git a/man/pw-loopback.1.rst.in b/man/pw-loopback.1.rst.in
new file mode 100644
index 000000000..0008c305b
--- /dev/null
+++ b/man/pw-loopback.1.rst.in
@@ -0,0 +1,79 @@
+pw-loopback
+###########
+
+------------------------
+PipeWire loopback client
+------------------------
+
+:Manual section: 1
+:Manual group: General Commands Manual
+
+SYNOPSIS
+========
+
+| **pw-loopback** [*options*]
+
+DESCRIPTION
+===========
+
+The *pw-loopback* program is a PipeWire client that uses the PipeWire
+loopback module to create loopback nodes, with configuration given via
+the command-line options.
+
+OPTIONS
+=======
+
+-h | --help
+  Show help.
+
+-r | --remote=NAME
+  The name of the *remote* instance to connect to. If left unspecified,
+  a connection is made to the default PipeWire instance.
+
+-n | --name=NAME
+  Name of the loopback node
+
+-g | --group=NAME
+  Name of the loopback node group
+
+-c | --channels=NUMBER
+  Number of channels to provide
+
+-m | --channel-map=MAP
+  Channel map (default ``[ FL, FR ]``)
+
+-l | --latency=LATENCY
+  Desired latency in ms
+
+-d | --delay=DELAY
+  Added delay in seconds (floating point allowed)
+
+-C | --capture=TARGET
+  Target device to capture from
+
+-P | --playback=TARGET
+  Target device to play to
+
+--capture-props=PROPS
+
+  Wanted properties of capture node (in JSON)
+
+--playback-props=PROPS
+
+  Wanted properties of capture node (in JSON)
+
+AUTHORS
+=======
+
+The PipeWire Developers <@PACKAGE_BUGREPORT@>; PipeWire is available from @PACKAGE_URL@
+
+SEE ALSO
+========
+
+``pipewire(1)``,
+``pw-cat(1)``,
+``pactl(1)``
+
+Other ways to create loopback nodes are adding the loopback module in
+the configuration of a PipeWire daemon, or loading the loopback module
+using Pulseaudio commands (``pactl load-module module-loopback ...``).