livetrax

History

Robin Gareus 1e380b1e2e GUI use updated XML::read_buffer API		2020-04-23 02:26:27 +02:00
..
ardour-util.sh.in	commandline session utilities	2015-12-16 00:25:07 +01:00
common.cc	Update utility and tools GPL boilerplate and (C) from git log	2019-08-03 15:53:17 +02:00
common.h
copy-mixer.cc
debug
example.cc
export.cc	GUI use updated XML::read_buffer API	2020-04-23 02:26:27 +02:00
fix_bbtppq.cc	fix error in multiple calls to SourceFactory::createWritable()	2020-03-23 21:47:13 -06:00
new_empty_session.cc	Don't print usage to stdout for invalid parameters	2019-08-15 01:09:26 +02:00
new_session.cc
README
run
wscript	Fix cross-compile linking (arm-linux ld)	2020-02-14 00:20:45 +01: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)


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