jackmesh 0.2.0

Python-based utility for managing Jack audio server connections with simple TOML config files.

jackmesh

Manage your Jack audio server connections with ease using jackmesh, a lightweight Python utility that leverages plain TOML configuration files.

Features

• Dump current Jack connections in TOML format.
• Load Jack connections from TOML files. Default fallback to loading from ~/.jack_connections.toml if no file specified.

Installation

pip install jackmesh

Usage

Dump Current Jack Connections

To dump current jack connections to stdout in TOML format:

jackmesh -d

You can also redirect this output to a file:

jackmesh -d > my_connections.toml

Load Jack Connections

Load jack connections using:

jackmesh -l path/to/your/file.toml

If no file is specified, jackmesh will by default look for ~/.jack_connections.toml:

jackmesh -l

The assumption is that the TOML file provides the complete connection configuration and no other connections shall exist. Before applying the config file all existing connections will be removed.

Configuration

jackmesh uses TOML format for its configuration files. An example of the configuration file:

[Pianoteq]
out_1 = [ "system:playback_FL",]
out_2 = [ "system:playback_FR",]

["Built-in Audio Pro"]
capture_AUX0 = [ "REAPER:in1",]
capture_AUX1 = [ "REAPER:in2",]

[REAPER]
out1 = [ "Built-in Audio Pro:playback_AUX0",]
out2 = [ "Built-in Audio Pro:playback_AUX1",]

The target port names in the lists can be given as substrings. A more robust implementation would be needed, like the possibility to specify target ports using regular expressions.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

See also

• jackmesh: A Tool for Managing Jack Audio Server Connections

License

GNU GPL v3