Skip to content

Latest commit

 

History

History
79 lines (50 loc) · 1.84 KB

README.md

File metadata and controls

79 lines (50 loc) · 1.84 KB

jackmesh

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

License

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

GNU GPL v3