Metadata-Version: 2.4
Name: pwconn
Version: 0.1.0
Summary: Manage Pipewire connections via a TUI
Author: Bill Gribble
Author-email: Bill Gribble <grib@billgribble.com>
License-Expression: GPL-2.0
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Programming Language :: Python
Classifier: Topic :: Multimedia :: Sound/Audio
Requires-Dist: textual>=5.3.0
Requires-Dist: textual-dev>=1.7.0
Requires-Python: >=3.13
Description-Content-Type: text/markdown

# 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'](https://github.com/astral-sh/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"
