-------------------------
-  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++ when needed).

The tools share the same base source code, so most of them look quite similar (which is intentional).

The basic modules are:
  jack_logs -> Show JACK, A2J, LASH and LADISH logs (just like the 'ladilog' app)
  jack_render -> Record a JACK project using jack-capture, controlled by JACK Transport; supports realtime and freewheel mode
  jack_settings -> Configure JACK (requires jackdbus, either JACK1+DBus patch or JACK2)

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.
Although this is the main app, it's the one that needs more work, so don't expect it to do much right now.

---> Catarina
A Patchbay test app.
Created while the patchcanvas module was being developed, it allows the user to experiment with the patchbay, without using JACK or LADISH.
You can save & load patchbay configurations too. Not sure how much useful this app is now though...

---> 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.

---> 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 'Klaudia' add-application style when using 'Klaudia' database mode.

---> 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, native and Windows VST.
This application is under heavy 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 for obvious reasons...

---> [JACK] 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.
This is more of a concept of my jacklib python module usage then anything else. May not work properly under very low JACK buffer sizes.