Man page - pw-link(1)
Packages contains this manual
- spa-monitor(1)
- pipewire-props(7)
- pw-reserve(1)
- pw-top(1)
- pw-play(1)
- pw-mon(1)
- pipewire.conf(5)
- spa-inspect(1)
- pw-encplay(1)
- pipewire-pulse.conf(5)
- pw-cli(1)
- pw-record(1)
- pipewire(1)
- spa-resample(1)
- pw-mididump(1)
- pw-link(1)
- spa-acp-tool(1)
- pipewire-jack.conf(5)
- pipewire-client.conf(5)
- pw-profiler(1)
- pw-container(1)
- pw-dsdplay(1)
- pipewire-avb(1)
- pw-midiplay(1)
- pw-cat(1)
- pw-config(1)
- pw-dot(1)
- pw-metadata(1)
- pw-midirecord(1)
- spa-json-dump(1)
- pipewire-filter-chain.conf(5)
- pw-loopback(1)
- pipewire-aes67(1)
- pw-dump(1)
apt-get install pipewire-bin
Manual
pw-link
NAMESYNOPSIS
DESCRIPTION
COMMON OPTIONS
LISTING PORTS AND LINKS
CONNECTING PORTS
DISCONNECTING PORTS
EXAMPLES
AUTHORS
SEE ALSO
NAME
pw-link - The PipeWire Link Command
SYNOPSIS
pw-link [ options ] -o-l [ out-pattern ] [ in-pattern ]
pw-link [ options ] output input
pw-link [ options ] -d output input
pw-link [ options ] -d link-id
DESCRIPTION
List, create and destroy links between PipeWire ports.
COMMON OPTIONS
-r | --remote=NAME
The name the remote instance to monitor. If left unspecified, a connection is made to the default PipeWire instance.
-h | --help
Show help.
--version
Show version information.
LISTING PORTS AND LINKS
Specify one of -o, -i or -l to list the matching optional input and output ports and their links.
-o | --output
List output ports
-i | --input
List input ports
-l | --links
List links
-m | --monitor
Monitor links and ports. pw-link will not exit but monitor and print new and destroyed ports or links.
-I | --id
List IDs. Also list the unique link and port ids.
-v | --verbose
Verbose port properties. Also list the port-object-path and the port-alias.
CONNECTING PORTS
Without any list option (-i, -o or -l), the given ports will be linked. Valid port specifications are:
port-id
As obtained with the -I option when listing ports.
node-name:port-name
As obtained when listing ports.
port-object-path
As obtained from the first alternative name for the port when listing them with the -v option.
port-alias
As obtained from the second alternative name for the ports when listing them with the -v option.
Extra options when linking can be given:
-L | --linger
Linger. Will create a link that exists after pw-link is destroyed. This is the default behaviour, unless the -m option is given.
-P | --passive
Passive link. A passive link will keep both nodes it links inactive unless another non-passive link is activating the nodes. You can use this to link a sink to a filter and have them both suspended when nothing else is linked to either of them.
-p | --props=PROPS
Properties as JSON object. Give extra properties when creaing the link.
DISCONNECTING PORTS
When the -d option is given, an existing link between port is destroyed.
To disconnect port, a single link-id , as obtained when listing links with the -I option, or two port specifications can be given. See the connecting ports section for valid port specifications.
-d | --disconnect
Disconnect ports
EXAMPLES
pw-link -iol
List all port and their links.
pw-link -lm
List all links and monitor changes until pw-link is stopped.
pw-link paplay:output_FL alsa_output.pci-0000_00_1b.0.analog-stereo:playback_FL
Link the given output port to the input port.
pw-link -lI
List links and their Id.
pw-link -d 89
Destroy the link with id 89.
AUTHORS
The PipeWire Developers <https://gitlab.freedesktop.org/pipewire/pipewire/issues>; PipeWire is available from <https://pipewire.org>
SEE ALSO
pipewire(1) , pw-cli(1)