--- README for Cadence ---

Cadence is a set of tools useful for audio production.
It's being developed by falkTX, using Python and Qt (and some C++ where needed).

The tools share the same base source code, so most of them look quite similar (which is intentional).
Also, lots of custom widgets were coded when needed (like pixmapdial, pixmapkeyboard, patchcanvas and systray).
They can be re-used in other projects. Contact the author if you need help on that.

Note that the main focus goes to JACK2 (or JACK1+DBus); JACK1 (raw) and tschack are untested and may not work properly at this point.

===== DESCRIPTIONS =====

Here's a brief description of the main tools:

Cadence

The main app. It performs system checks, manages JACK, calls other tools and make system tweaks.
Currently under development, may change at anytime.

Cadence-JackMeter

Digital peak meter for JACK.
It automatically connects itself to all application JACK output ports that are also connected to the system output.

Cadence-JackSettings

Simple and easy-to-use configure dialog for jackdbus.
It can configure JACK's driver and engine parameters, and it also supports LADISH studios.

Cadence-Logs

Small tool that shows JACK, A2J, LASH and LADISH logs in a multi-tab window.
The logs are viewed in a text box, making it easy to browse and extract status messages using copy and paste commands.

Cadence-Render

Tool to record (or ‘render’) a JACK project using jack-capture, controlled by JACK Transport.
It supports a vast number of file types and can render in both realtime and freewheel modes.

Cadence-XY Controller

Simple XY widget that sends and receives data from Jack MIDI.
It can send data through specific channels and has a MIDI Keyboard too.

Catarina

A Patchbay test app, created while the patchcanvas module was being developed.
It allows the user to experiment with the patchbay, without using ALSA, JACK or LADISH.
You can save & load patchbay configurations too.

Catia

JACK Patchbay, with some neat features like A2J bridge support and JACK Transport.
It's supposed to be as simple as possible (there's Claudia for advanced things), so it can work nicely on Windows and Mac too.
Currently has ALSA-MIDI support in experimental stage (it doesn't automatically refresh the canvas when changes happen externally).

Claudia

LADISH frontend; just like Catia, but focused at session management through LADISH.
It has a bit more features than the official LADISH GUI, with a pretty preview of the main canvas in the bottom-left.
It also implements the ‘Claudia-Launcher’ add-application style.

Claudia-Launcher

A multimedia application launcher with LADISH support.
It searches for installed packages (not binaries), and displays the respective content as a launcher.
The content is got through an hardcoded database, created and/or modified to suit the target distribution.
Currently supports Debian and ArchLinux based distros.

Carla

Multi-plugin host for JACK.
It has some nice features like automation of parameters via MIDI CCs (and send control outputs back to MIDI too) and full OSC control.
Currently supports LADSPA (including LRDF), DSSI, LV2, and VST plugin formats, with additional GIG, SF2 and SFZ file support via FluidSynth and LinuxSampler.
This application is still under development and may change/break at anytime.

Carla-Control

An OSC Control GUI for Carla (you get the OSC address from the Carla's about dialog, and connect to it).
Supports controlling main UI components (Dry/Wet, Vol and Balance), and all plugins parameters.
Peak values and control outputs are displayed as well.
Custom Plugin GUIs are not supported at this point.
NOTE: This application is not yet ported to this python3 branch