summaryrefslogtreecommitdiff
path: root/share/scripts/README
diff options
context:
space:
mode:
Diffstat (limited to 'share/scripts/README')
-rw-r--r--share/scripts/README29
1 files changed, 29 insertions, 0 deletions
diff --git a/share/scripts/README b/share/scripts/README
new file mode 100644
index 0000000000..2527498ee3
--- /dev/null
+++ b/share/scripts/README
@@ -0,0 +1,29 @@
+Ardour Lua Scripts
+==================
+
+https://manual.ardour.org/lua-scripting/
+
+For upstream script addition, please file a pull-request at
+https://github.com/Ardour/ardour/tree/master/scripts
+
+Script Naming conventions:
+
+^_
+ A script filename with a leading underscore indicates an example script.
+ These scripts are only available from ardour's git repository and not
+ installed nor included with binary bundles.
+
+^__
+ Scripts with a filename starting with two underscores are excluded from
+ unit-tests. This is currently the case for convolver, fluidsynth and
+ plugin-modulation.
+ They depend on external files (soundfont, impulse-response) or a specific
+ session-setup (plugin-modulation needs an automatable plugin).
+
+^s_
+ A filename beginning with "s_" indicates a code snippet.
+ These scripts can only be used in the interactive interpreter
+ (Window > Scripting). They may be useful by themselves or handy for copy/edit
+ to create EditorActions.
+ The filename prefix is only for convenience, "type" = "Snippet" is used when
+ scripts are listed at runtime.