# jack-audio-tools
A collection of utilities and tools for the [JACK] audio ecosystem
## JACK Transport
The scripts in the `jackaudiotools.transport` package query or manipulate the
JACK transport state.
They require the [JACK-Client] package to be installed, which will be installed
automatically, when you install the `jack-audio-tools` distribution via `pip`:
pip install jack-audio-tools
### `jack-midi-to-transport`
JACK client which allows to control transport state via MIDI.
The client provides a MIDI input and converts received MIDI system real-time
and MIDI machine control (MMC) messages into JACK transport commands.
The following MIDI messages, when received, start the JACK transport:
* `START` (System Real-time)
* `CONTINUE` (System Real-time)
* `PLAY` (MMC)
* `DEFERRED PLAY` (MMC)
These messages stop the transport:
* `STOP` (System Real-time)
* `STOP` (MMC)
* `PAUSE` (MMC)
* `RESET` (MMC)
And these rewind the transport to frame zero:
* `REWIND` (MMC)
* `RESET` (MMC)
MMC messages are ignored, if the device number in the MMC System Exclusive
message does not match the client's device number (set with the -d command
line option).
If the client's device number is set to 127 (the default), it matches all
MMC message device numbers.
### `jack-rtmidi-to-transport`
JACK client which allows to control transport state via MIDI.
A variant of `midi_to_transport`, which uses the [python-rtmidi] package
as a MIDI backend instead of JACK-Client, which is slightly more efficient,
because MIDI input processing is happening in a C++ thread instead of a
Python callback.
To use it, specify the `rtmidi` extra dependency when installing the
`jack-audio-tools` distribution via `pip`:
pip install "jack-audio-tools[rtmidi]"
### `jack-timebase-master`
A simple JACK timebase master, which provides musical timing related
information (i.e. currents bar, beats per bar, beat denominator, BPM etc.)
to other JACK clients.
### `jack-transporter`
Query or change the JACK transport state.
## JACK D-BUS
The scripts in the `jackaudiotools.jackdbus` package interface with the JACK
D-BUS service to query information about the status of the JACK server and/or
control its operation.
These scripts require the [PyGobject] and [dbus-python] packages to be
installed. To install these, specify the `dbus` extra dependency when
installing the `jack-audio-tools` distribution via `pip`:
pip install "jack-audio-tools[dbus]"
### `jack-dbus-monitor`
This script monitors the JACK server via D-BUS and runs a command on status
changes and optionally at a given interval passing some JACK stats in the
environment.
Here is an example shell script to use as a command:
```bash
#!/bin/bash
event="$1" # 'start', 'stop' or 'status'
echo "JACK event: $event"
if [[ "$event" = "status" ]]; then
echo "IS_STARTED: $IS_STARTED"
echo "IS_REALTIME: $IS_REALTIME"
echo "PERIOD: $PERIOD"
echo "LATENCY: $LATENCY"
echo "LOAD: $LOAD"
echo "XRUNS: $XRUNS"
echo "SAMPLERATE: $SAMPLERATE"
fi
```
Save this as `jack_status.sh` and use it like so:
```console
jack-dbus-monitor --interval-stats 1000 ./jack_status.sh
```
## LV2
The scripts in the `jackaudiotools.lv2` package help with querying information
from the [LV2] plugins installed on the system.
They require the [lilv] Python bindings to be installed. Unfortunately, these
can not be installed from the Python Package Index. Instead, install a recent
version of the `lilv` library, either from your distribution's package
repository or from source.
### `lv2-grep`
Print URIs of all installed LV2 plugins matching the given regular expression.
Can optionally output the list of matching plugins in JSON format, where each
list item is an object with the plugin name and uri and optionally the list of
categories the plugin belongs to, as properties.
### `lv2-plugin-uris`
Print a list of all URIs associated with an LV2 plugin.
### `lv2-list-plugin-presets`
List all presets of an LV2 plugin with the given URI.
### `lv2-plugin-info`
Generate a JSON document with information about a single or all installed LV2
plugins. This allows plugin meta data to be loaded quickly in other programs.
Depending on the number of plugins installed on your system, this script may
run for several seconds or even minutes and produce an output file of several
megabytes in size.
## Carla
The scripts in the `jackaudiotools.carla` package manipulate or query [Carla]
project files.
### `carxp2lv2presets`
Export plugin settings from a Carla project file (.carxp) as LV2 preset bundles.
This script requires the [rdflib] package to be installed. To install it,
specify the `rdflib` extra dependency when installing the `jack-audio-tools`
distribution via `pip`:
pip install "jack-audio-tools[rdflib]"
## License
This software is distributed under the MIT License.
See the file [LICENSE](./LICENSE) for more information.
## Author
This software is written by *Christopher Arndt*.
[carla]: https://kx.studio/Applications:Carla
[dbus-python]: https://pypi.org/project/dbus-python
[jack-client]: https://pypi.org/project/JACK-Client
[jack]: https://jackaudio.org/
[lilv]: http://drobilla.net/software/lilv
[lv2]: http://lv2plug.in/
[PyGObject]: https://pypi.org/project/PyGobject
[python-rtmidi]: https://pypi.org/project/python-rtmidi
[rdflib]: https://pypi.org/project/rdflib
Raw data
{
"_id": null,
"home_page": "https://github.com/SpotlightKid/jack-audio-tools",
"name": "jack-audio-tools",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3",
"maintainer_email": "",
"keywords": "jack,jackaudio,LV2,carla,MIDI",
"author": "Christopher Arndt",
"author_email": "info@chrisarndt.de",
"download_url": "https://files.pythonhosted.org/packages/e4/c0/2031e4044615eb70646bf690055ab743088425f71e4df20815cd9ea457ca/jack-audio-tools-0.4.1.tar.gz",
"platform": null,
"description": "# jack-audio-tools\n\nA collection of utilities and tools for the [JACK] audio ecosystem\n\n\n## JACK Transport\n\nThe scripts in the `jackaudiotools.transport` package query or manipulate the\nJACK transport state.\n\nThey require the [JACK-Client] package to be installed, which will be installed\nautomatically, when you install the `jack-audio-tools` distribution via `pip`:\n\n pip install jack-audio-tools\n\n\n### `jack-midi-to-transport`\n\nJACK client which allows to control transport state via MIDI.\n\nThe client provides a MIDI input and converts received MIDI system real-time\nand MIDI machine control (MMC) messages into JACK transport commands.\n\nThe following MIDI messages, when received, start the JACK transport:\n\n* `START` (System Real-time)\n* `CONTINUE` (System Real-time)\n* `PLAY` (MMC)\n* `DEFERRED PLAY` (MMC)\n\nThese messages stop the transport:\n\n* `STOP` (System Real-time)\n* `STOP` (MMC)\n* `PAUSE` (MMC)\n* `RESET` (MMC)\n\nAnd these rewind the transport to frame zero:\n\n* `REWIND` (MMC)\n* `RESET` (MMC)\n\nMMC messages are ignored, if the device number in the MMC System Exclusive\nmessage does not match the client's device number (set with the -d command\nline option).\n\nIf the client's device number is set to 127 (the default), it matches all\nMMC message device numbers.\n\n\n### `jack-rtmidi-to-transport`\n\nJACK client which allows to control transport state via MIDI.\n\nA variant of `midi_to_transport`, which uses the [python-rtmidi] package\nas a MIDI backend instead of JACK-Client, which is slightly more efficient,\nbecause MIDI input processing is happening in a C++ thread instead of a\nPython callback.\n\nTo use it, specify the `rtmidi` extra dependency when installing the\n`jack-audio-tools` distribution via `pip`:\n\n pip install \"jack-audio-tools[rtmidi]\"\n\n\n### `jack-timebase-master`\n\nA simple JACK timebase master, which provides musical timing related\ninformation (i.e. currents bar, beats per bar, beat denominator, BPM etc.)\nto other JACK clients.\n\n\n### `jack-transporter`\n\nQuery or change the JACK transport state.\n\n\n## JACK D-BUS\n\nThe scripts in the `jackaudiotools.jackdbus` package interface with the JACK\nD-BUS service to query information about the status of the JACK server and/or\ncontrol its operation.\n\nThese scripts require the [PyGobject] and [dbus-python] packages to be\ninstalled. To install these, specify the `dbus` extra dependency when\ninstalling the `jack-audio-tools` distribution via `pip`:\n\n pip install \"jack-audio-tools[dbus]\"\n\n\n### `jack-dbus-monitor`\n\nThis script monitors the JACK server via D-BUS and runs a command on status\nchanges and optionally at a given interval passing some JACK stats in the\nenvironment.\n\nHere is an example shell script to use as a command:\n\n```bash\n#!/bin/bash\n\nevent=\"$1\" # 'start', 'stop' or 'status'\necho \"JACK event: $event\"\n\nif [[ \"$event\" = \"status\" ]]; then\n echo \"IS_STARTED: $IS_STARTED\"\n echo \"IS_REALTIME: $IS_REALTIME\"\n echo \"PERIOD: $PERIOD\"\n echo \"LATENCY: $LATENCY\"\n echo \"LOAD: $LOAD\"\n echo \"XRUNS: $XRUNS\"\n echo \"SAMPLERATE: $SAMPLERATE\"\nfi\n```\n\nSave this as `jack_status.sh` and use it like so:\n\n```console\njack-dbus-monitor --interval-stats 1000 ./jack_status.sh\n```\n\n\n## LV2\n\nThe scripts in the `jackaudiotools.lv2` package help with querying information\nfrom the [LV2] plugins installed on the system.\n\nThey require the [lilv] Python bindings to be installed. Unfortunately, these\ncan not be installed from the Python Package Index. Instead, install a recent\nversion of the `lilv` library, either from your distribution's package\nrepository or from source.\n\n\n### `lv2-grep`\n\nPrint URIs of all installed LV2 plugins matching the given regular expression.\n\nCan optionally output the list of matching plugins in JSON format, where each\nlist item is an object with the plugin name and uri and optionally the list of\ncategories the plugin belongs to, as properties.\n\n\n### `lv2-plugin-uris`\n\nPrint a list of all URIs associated with an LV2 plugin.\n\n\n### `lv2-list-plugin-presets`\n\nList all presets of an LV2 plugin with the given URI.\n\n\n### `lv2-plugin-info`\n\nGenerate a JSON document with information about a single or all installed LV2\nplugins. This allows plugin meta data to be loaded quickly in other programs.\n\nDepending on the number of plugins installed on your system, this script may\nrun for several seconds or even minutes and produce an output file of several\nmegabytes in size.\n\n\n## Carla\n\nThe scripts in the `jackaudiotools.carla` package manipulate or query [Carla]\nproject files.\n\n\n### `carxp2lv2presets`\n\nExport plugin settings from a Carla project file (.carxp) as LV2 preset bundles.\n\nThis script requires the [rdflib] package to be installed. To install it,\nspecify the `rdflib` extra dependency when installing the `jack-audio-tools`\ndistribution via `pip`:\n\n pip install \"jack-audio-tools[rdflib]\"\n\n\n## License\n\nThis software is distributed under the MIT License.\n\nSee the file [LICENSE](./LICENSE) for more information.\n\n\n## Author\n\nThis software is written by *Christopher Arndt*.\n\n\n[carla]: https://kx.studio/Applications:Carla\n[dbus-python]: https://pypi.org/project/dbus-python\n[jack-client]: https://pypi.org/project/JACK-Client\n[jack]: https://jackaudio.org/\n[lilv]: http://drobilla.net/software/lilv\n[lv2]: http://lv2plug.in/\n[PyGObject]: https://pypi.org/project/PyGobject\n[python-rtmidi]: https://pypi.org/project/python-rtmidi\n[rdflib]: https://pypi.org/project/rdflib\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "A collection of utilities and tools for the JACK audio ecosystem",
"version": "0.4.1",
"project_urls": {
"Homepage": "https://github.com/SpotlightKid/jack-audio-tools"
},
"split_keywords": [
"jack",
"jackaudio",
"lv2",
"carla",
"midi"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2ccd7d820a8d6d30f9d0bc6eccb8f938eb2426db6f5459b54d9e6eb4b13b380c",
"md5": "5bb381cda510506264a78d02ffa79744",
"sha256": "57540c325d1d4e41ade653e5a72f5b8f7f21f91f5e964920c60a631ca0f9df81"
},
"downloads": -1,
"filename": "jack_audio_tools-0.4.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5bb381cda510506264a78d02ffa79744",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3",
"size": 25759,
"upload_time": "2023-06-10T14:36:07",
"upload_time_iso_8601": "2023-06-10T14:36:07.977417Z",
"url": "https://files.pythonhosted.org/packages/2c/cd/7d820a8d6d30f9d0bc6eccb8f938eb2426db6f5459b54d9e6eb4b13b380c/jack_audio_tools-0.4.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e4c02031e4044615eb70646bf690055ab743088425f71e4df20815cd9ea457ca",
"md5": "c8b6729ca958e422cf1580a76bfadb4e",
"sha256": "030ea28165551f801d7c9170c1fd06da5fa7b0473d7c9d37f7bc4351b0955191"
},
"downloads": -1,
"filename": "jack-audio-tools-0.4.1.tar.gz",
"has_sig": false,
"md5_digest": "c8b6729ca958e422cf1580a76bfadb4e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3",
"size": 22040,
"upload_time": "2023-06-10T14:36:09",
"upload_time_iso_8601": "2023-06-10T14:36:09.877106Z",
"url": "https://files.pythonhosted.org/packages/e4/c0/2031e4044615eb70646bf690055ab743088425f71e4df20815cd9ea457ca/jack-audio-tools-0.4.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-10 14:36:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "SpotlightKid",
"github_project": "jack-audio-tools",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "jack-audio-tools"
}
JSON
