aboutsummaryrefslogtreecommitdiffstats
path: root/plugins/LV2/README.md
blob: 0ffaf1529b981e7c6d47683c8b39856bc8e4ab3d (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
# Airwindows open-source LV2 plugins for Linux

This repository contains a CMake project that builds Airwindows plugins for
Linux. Thanks to the Patreon supporters, Chris now publishes some of his plugins
under the MIT license on his GitHub, thus making this possible. Please, consider
supporting him. More info:

1. <https://patreon.com/airwindows>
2. <https://github.com/airwindows/airwindows>
3. <http://airwindows.com>

This port to the LV2 plugin format is done by Harald Eilertsen, based on the CMake
buildsystem [Eugene Cherny](https://github.com/ech2) made for the LinuxVST port
of the plugins.

1. <https://code.volse.net/audio/plugins/airwindows-lv2-port.git>

A mailing list has been set up for tracking the development of this port, as well
as for receiving patches, issues etc. If you're interested in following the progress
of this porting effort, please subscribe.

1. <https://listserv.volse.net/info/audioplugins>

## Building

Install CMake from your package manager:

- Debian / Ubuntu: `apt install cmake`
- Fedora / CentOS: `dnf install cmake`
- Arch / Manjaro: `pacman -S cmake`

Then make a directory where you want the project built, `build` is a good candidate.
Then:

```
% cd build
% cmake -DCMAKE_BUILD_TYPE=Release ..
% make
```

You should now have a `lv2` subdirectory with another level of subdirectories,
one for each plugin, copy these to your LV2 folder to install:

```
% mkdir ~/.lv2
% cp -r ./lv2/* ~/.lv2/
```

To build a debug build, set `CMAKE_BUILD_TYPE=Debug` instead.

## Adding new plugins

1. Create a new directory `PluginName` in the `src` dir.
2. Copy the plugin’s `.cpp` and `.h` files to it.
3. Add line `add_airwindows_plugin(PluginName)` to the root `CMakeLists.txt`.
   This will create a new target `PluginName` with all the sources copied, as