https://github.com/jackaudio/jack-example-tools
Official examples and tools from the JACK project
https://github.com/jackaudio/jack-example-tools
Last synced: about 1 year ago
JSON representation
Official examples and tools from the JACK project
- Host: GitHub
- URL: https://github.com/jackaudio/jack-example-tools
- Owner: jackaudio
- License: gpl-2.0
- Created: 2021-10-03T13:53:51.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-07-07T16:28:29.000Z (almost 2 years ago)
- Last Synced: 2025-04-04T18:39:14.101Z (about 1 year ago)
- Language: C
- Homepage:
- Size: 642 KB
- Stars: 44
- Watchers: 14
- Forks: 15
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# JACK example tools
This repository holds the official JACK example clients and tools, which have
been tracked in the
[example-clients](https://github.com/jackaudio/example-clients) and
[tools](https://github.com/jackaudio/tools) repositories in the past.
## Dependencies
The project requires the following dependencies:
* [alsa-lib](https://www.alsa-project.org/wiki/Main_Page) (required when
building `alsa_in` and `alsa_out` or ZALSA internal clients)
* [jack1](https://github.com/jackaudio/jack1) >= 0.126.0,
[jack2](https://github.com/jackaudio/jack2) >= 1.9.20, or
[pipewire-jack](https://gitlab.freedesktop.org/pipewire/pipewire) >= 0.3.44
(other versions may work but are not supported)
* [opus](https://www.opus-codec.org/) (optional buildtime/ runtime dependency
for `jack_netsource`)
* [readline](https://tiswww.case.edu/php/chet/readline/rltop.html) (optional
buildtime/ runtime dependency for `jack_transport`)
* [libsamplerate](https://libsndfile.github.io/libsamplerate/) (required when
building `alsa_in` and `alsa_out` or `jack_netsource`)
* [libsndfile](https://libsndfile.github.io/libsndfile/) (required when
building `jack_rec`)
* [libzita-alsa-pcmi](https://kokkinizita.linuxaudio.org/linuxaudio/) (required
when building ZALSA internal clients)
* [libzita-resampler](https://kokkinizita.linuxaudio.org/linuxaudio/) (required
when building ZALSA internal clients)
For all available options please refer to
[meson_options.txt](meson_options.txt) or run `meson configure` in the project
directory.
## Building
jack-example-tools uses the [meson build system](https://mesonbuild.com).
To configure the project, meson's [universal
options](https://mesonbuild.com/Builtin-options.html#universal-options) (e.g.
**--prefix**) can be used to prepare a build directory:
```bash
meson --prefix=/usr build
```
To build the applications and libraries [ninja](https://ninja-build.org/) is
required:
```bash
ninja -C build
```
## Installing
Meson is able to install the project components to the system directories (when
run as root), while honoring the **DESTDIR** environment variable:
```bash
DESTDIR="/some/other/location" meson install -C build
```
## Releases
[Releases of
jack-example-tools](https://github.com/jackaudio/jack-example-tools/tags) are
created by its current maintainer [Filipe Coelho](https://github.com/falktx)
(`62B11043D2F6EB6672D93103CDBAA37ABC74FBA0`).
To verify a tag, first import the relevant PGP key:
```
gpg --auto-key-locate wkd,keyserver --search-keys falktx@falktx.com
```
Afterwards a tag can be verified from a clone of this repository:
```
git verify-tag
```
## License
All files (unless noted otherwise) are licensed under the terms of the
**GPL-2.0-or-later** (see [LICENSE](LICENSE)).
The code in [tools/zalsa](tools/zalsa) is provided via [Fons Adriansen's
zita-ajbridge](https://kokkinizita.linuxaudio.org/linuxaudio/zita-ajbridge-doc/quickguide.html)
and licensed under the terms of the **GPL-3.0-or-later** (see
[tools/zalsa/LICENSE](tools/zalsa/LICENSE)).