Python-based utility for managing Jack audio server connections with simple TOML config files.
Project description
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",]
Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
See also
License
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.