summaryrefslogtreecommitdiff
path: root/session_utils/README
diff options
context:
space:
mode:
Diffstat (limited to 'session_utils/README')
-rw-r--r--session_utils/README29
1 files changed, 29 insertions, 0 deletions
diff --git a/session_utils/README b/session_utils/README
new file mode 100644
index 0000000000..510e3a4e1e
--- /dev/null
+++ b/session_utils/README
@@ -0,0 +1,29 @@
+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.
+
+
+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 ardour4-your_new_tool_name