ardour

History

Mads Kiilerich d220f477ed wscript: drop unused "mandatory variables" 'top' and 'out' in libs Variables by these names are only used from the local wscript and when running "waf configure", which already for other reasons only can run at the top-level. These variables are thus not mandatory and not used.		2023-09-17 07:34:55 -06:00
..
ardour-util.sh.in
common.cc	Utils: Fix crash at exit due to engine destruction	2023-06-15 16:22:23 +02:00
common.h
copy-mixer.cc	Make RCU reader return a const pointer (omnibus commit)	2023-04-08 00:15:37 +02:00
debug
example.cc
export.cc	switch from boost::{shared,weak}_ptr to std::{shared,weak}_ptr	2023-03-24 14:19:15 -06:00
new_empty_session.cc	Change tools --help URLs to use https	2022-10-24 04:57:30 +02:00
new_session.cc	Change tools --help URLs to use https	2022-10-24 04:57:30 +02:00
README
run
wscript	wscript: drop unused "mandatory variables" 'top' and 'out' in libs	2023-09-17 07:34:55 -06:00

README

Ardour Session Utilities
========================

This folder contains some tools which directly use libardour to access ardour
sessions.

The overall goal it to provide some non-interactive unix-style commandline
tools, which are installed along with DAW.

These tools depend on the "dummy" backend to be available, configure ardour with e.g.

  ./waf configure --with-backends=jack,alsa,dummy ...


Adding new tools
----------------

One C++ source per tool, see "example.cc" and "export.cc"

  cp session_utils/example.cc session_utils/your_new_tool_name.cc
  edit session_utils/new_tool_name.cc
  ./waf

The tool is automatically compiled and deployed when installing, using the
program-name as prefix.  e.g.  "export.cc" becomes "ardour4-export"
(or "mixbus3-export", depending on the project configuration).
Tool names must start with lower-case alphabetic letter [a-z].


Test run from the source
------------------------

  cd session_utils
  ./run ardour6-your_new_tool_name

or

  ./run ardour6-export --help

and to debug the tool under gdb/lldb:

  ./debug ardour6-export