--- /dev/null
+---
+layout: default
+title: Files and Directories Ardour Knows About
+---
+
+<h2>Configuration Directories</h2>
+<p>
+ Ardour stores configuration files in two places. The system configuration
+ directory and the user configuration directory. The system configuration
+ directory is used for stock configuration files and is used by all
+ users on any one system. The user configuration directory is used by
+ Ardour to store configuration changes made in the GUI as well as being
+ a place the user can add control surface device files, scripts etc.
+</p>
+
+<p>
+ Ardour tries to use standard places for these directories for the platform
+ it is running on.
+</p>
+<h3>Linux</h3>
+<p>
+ Linux is the most variable of the platforms mainly due to Ardour obtained from
+ a distro package. If Ardour is obtained from ardour.org as a ready to install
+ and run bundle, the system configuration directory will always be in
+ /opt/Ardour-major.minor.sub/share/ That is it will match the name of the
+ file you downloaded. If Ardour is self built and installed with the
+ default install path (yes you can change this) then system configuration
+ will be in /usr/local/share/ardour*/ where * is the major number such as
+ /usr/local/share/ardour5/ for Ardour 5.6. If you have installed Ardour
+ as a package from your distro, then distro policy will dictate where
+ it is installed. /usr/share/ardour*/ is quite common and a good place to start
+ looking. However, the Ardour development team does not support these
+ distro builds nor keep track of where they may put things.
+</p>
+<p>
+ The user configuration directory will be somewhere inside the user's
+ home directory. A normal place to find this is ~/.config/ardour*/ where
+ * is the major version. However this can be set by the system with the
+ $XDG_CONFIG_HOME environment variable to something else. If you can not
+ find ~/.config/ on your system try echo ${XDG_CONFIG_HOME} to see if your
+ distro is using something else.
+</p>
+<h3>OSx or MacOS</h3>
+<p>
+ maybe someone who has a MAC can complete this section.
+</p>
+<h3>Windows</h3>
+<p>
+ This section also needs someone with real knowledge to complete it.
+</p>
+
+<h2>Plugins</h2>
+<p>
+ Plugins will be installed in various places, some by standard and some
+ by developer whim. Some are installed incorrectly by distro policy.
+</p>
+
+<h3>Linux</h3>
+<p>
+ In linux there are 3 kinds of plugins Ardour can use. LADSPA, LV2 (LADSPA version 2)
+ or lxvst (VSTs compiles as native linux binaries). While it is possible
+ with some strange magic to run <a href="/working-with-plugins/windows-vst-support/">Windows VSTs</a>
+ on linux, their whereabouts would follow the Windows info below.
+</p>
+
+<h4>LADSPA</h4>
+<p>
+ LADSPA plugins should be found in /usr/lib/ladspa/, /usr/local/lib/ladspa/
+ or in a directory mentioned in your LADSPA_PATH environment variable.
+ The most common mistake made by distro packagers, is to use a path
+ like /usr/lib/$ARCH/ladspa/ and find that Ardour will not find that by
+ default. The user can either add a link from this actual directory to
+ the standard directory or add this path to LADSPA_PATH.
+</p>
+
+<h4>LV2</h4>
+<p>
+ LADSPA plugins should be found in /usr/lib/lv2/, /usr/local/lib/lv2/
+ or in a directory mentioned in your LV2_PATH environment variable.
+ The most common mistake made by distro packagers, is to use a path
+ like /usr/lib/$ARCH/lv2/ and find that Ardour will not find that by
+ default. The user can either add a link from this actual directory to
+ the standard directory or add this path to LV2_PATH.
+</p>
+
+<h4>Linux VST or lxvst</h4>
+<p>
+ They are typically installed in /usr/lib/lxvst, /usr/local/lib/lxvst or
+ a directory mentioned in your LXVST_PATH environment variable. However,
+ this is not a standard and the VST plugin developer may install the plugin
+ just about anywhere. Therefore Ardour allows the user to set extra VST
+ paths in the preferences GUI under Plugins>VST.
+</p>
+
+<h3>OSX or MacOS</h3>
+<p>
+ On the Mac, plugins are expected to be installed correctly Ardour uses
+ the system tool to scan for AU style plugins and LV2s should be in the right
+ place. LV2 should be in $HOME/Library/Audio/Plug-Ins/LV2
+ /Library/Audio/Plug-Ins/LV2
+ /usr/local/lib/lv2
+ /usr/lib/lv2
+ If an AU or LV2 plugin does not show up on a Mac it is probably
+ a development fault with the plugin and the plugin will not work with anything.
+ Ardour in Ardour 5.6 has support for native VST plugins. That is VST
+ plugins built for OSX. I am not sure if these have a standard place to
+ be, but as with other VSTs the search path can be edited at Plugins>VST.
+</p>
+
+<h3>Windows</h3>
+<p>
+ The most common plugins on Windows are VSTs. However, LADSPA and LV2
+ plugins are available for windows as well. In fact Ardours built in
+ plugins are LV2s. The biggest advanatage of LV2 plugins is that they are
+ the most likely to be cross platform and therefore allow the same Ardour
+ project to be worked on in Windows, OSX and Linux.
+</p>
+
+<h4>VST</h4>
+<p>
+ As with other platforms, VSTs on Windows do not have a standard place
+ to reside. Ardour Preferences>Plugins>VST allows setting the VST path
+ from the GUI.
+</p>
+<h4>LV2</h4>
+<p>
+ The LV2 standard for Windows is %APPDATA%/LV2 or %COMMONPROGRAMFILES%/LV2
+</p>
+
+<h4>LADSPA</h4>
+<p>
+ While there are LADSPA plugins for Windows, I have been unable to find
+ the standard path for them... perhaps someone knows?
+</p>
+
+<h2>Project Directory</h2>
+<p>
+ Ardour places a project directory where the user tells it to. This
+ directory is chosen when creating a project. In most cases the user
+ does not need to know about the files inside of the project directory.
+ However there are a few subdirectories worth noting.
+</p>
+<h3>export</h3>
+<p>
+ This is the subdirectory where exported files end up.
+</p>