2015-12-15 18:25:07 -05:00
|
|
|
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.
|
|
|
|
|
|
2017-09-27 14:03:08 -04:00
|
|
|
These tools depend on the "dummy" backend to be available, configure ardour with e.g.
|
|
|
|
|
|
|
|
|
|
./waf configure --with-backends=jack,alsa,dummy ...
|
|
|
|
|
|
2015-12-15 18:25:07 -05:00
|
|
|
|
|
|
|
|
Adding new tools
|
|
|
|
|
----------------
|
|
|
|
|
|
2017-09-27 14:03:08 -04:00
|
|
|
One C++ source per tool, see "example.cc" and "export.cc"
|
2015-12-15 18:25:07 -05:00
|
|
|
|
|
|
|
|
cp session_utils/example.cc session_utils/your_new_tool_name.cc
|
|
|
|
|
edit session_utils/new_tool_name.cc
|
2017-09-27 14:03:08 -04:00
|
|
|
./waf
|
2015-12-15 18:25:07 -05:00
|
|
|
|
|
|
|
|
The tool is automatically compiled and deployed when installing, using the
|
2020-11-14 19:21:40 -05:00
|
|
|
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].
|
2015-12-15 18:25:07 -05:00
|
|
|
|
|
|
|
|
|
|
|
|
|
Test run from the source
|
|
|
|
|
------------------------
|
|
|
|
|
|
|
|
|
|
cd session_utils
|
2017-09-27 14:03:08 -04:00
|
|
|
./run ardour6-your_new_tool_name
|
|
|
|
|
|
|
|
|
|
or
|
|
|
|
|
|
|
|
|
|
./run ardour6-export --help
|
|
|
|
|
|
|
|
|
|
and to debug the tool under gdb/lldb:
|
|
|
|
|
|
|
|
|
|
./debug ardour6-export
|
