pwconn 0.1.0

Manage Pipewire connections via a TUI

pwconn -- manage Pipewire connections via TUI

pwconn serves the same basic function as qpwgraph: it allows you to view, create, and remove connections between Pipewire apps. It is a UI wrapper on the command-line utils pw-cli, pw-link, and aconnect.

It is under development and not releasable yet, but if you want to play around with it much of the functionality is there.

Requirements:

• 'uv' for build/install (I wanted to give it a try, seems ok but jury is still out)
• alsa-tools from your Linux distribution, for the aconnect tool
• pw-utils from your Linux distribution, for the pw-cli and pw-link tools.

Build/install

I haven't uploaded to pypi yet. For now, options are:

• Launch the project from the source tree with uv run pwconn
• Install from source locally
  • Build wheel with uv build
  • Optional: create and activate a virtualenv for the install
    • python3 -m venv <destination>
    • . <destination>/bin/activate
  • Install the wheel with pip install dist/pwconn-0.1.0-py3-none-any.whl
  • Launch as pwconn

Usage

• The main UI is a list of Pipewire devices of a single kind (audio, JACK MIDI, ALSA MIDI, or video).

• Select a line in the list by up and down arrow keys or mouse click

• Keyboard commands are listed at the bottom of the screen

• The keys [, ], {, and } expand and collapse. Devices expand to show ports, and ports expand to show connections

• The keys "a", "j", "m", and "v" switch which kind of device is displayed

• When a port is selected, the space key will "mark" it.

• To make one or more connections, mark all of the connection endpoints and press "c". If there are multiple ins and outs selected it will make a reasonable choice of connections which is generally OK. If not, make the connections one at a time.

• To disconnect, select a link (from either "end") and type "d"