aboutsummaryrefslogtreecommitdiffstats
path: root/plugins/AirwindowsLinuxVSTTemplate.txt
blob: dae7f5a9f6ad5eeab5a74413c0542298fd6a2574 (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
58
59
60
61
62
63
64
65
66
67
68
69
# from LinuxVST/README.md

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 CMake project is created by Eugene Cherny, whose work with CMake and scripting
allowed for every Airwindows plugin to be conveniently ported to LinuxVST, and
allowed for Linux as a platform to be targeted from now on. Thank you, ech2!
1. <https://github.com/ech2>
2. <http://oscii.ru>

[[Download build](https://github.com/ech2/airwindows-ports/releases)]

## Building

Install CMake from your package manager:

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

To build the plugins you would need to grab the VST SDK and copy it to the
`include/vstsdk` directory. You need to do it yourself, because the Steinberg’s
license doesn’t allow to distribute their SDK with licenses other than GPL. You
can get it from the following page:
<https://www.steinberg.net/en/company/developers.html>. The structure of the
`include/vsdsdk` directory should be as follows:

```
include/vstsdk/
├── pluginterfaces
│   └── vst2.x
│       ├── aeffect.h
│       ├── aeffectx.h
│       └── vstfxstore.h
├── aeffeditor.h
├── audioeffect.cpp
├── audioeffect.h
├── audioeffectx.cpp
├── audioeffectx.h
├── CMakeLists.txt
└── vstplugmain.cpp
```

Then, navigate to the `build` directory and run `cmake .. && make`. A number of
`.so` files should appear — these are your plugins. Copy them wherever you
would like or wherever your DAW can find them.

## 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
   well as include VST-related files.
4. Build the project.

## What’s needed

- [X] Check the VS / Xcode projects for some extra compilation flags and add it
    to this project.
- [ ] Try to make this build cross-platform and generate Xcode and VS projects.
- [ ] Automatic builds for different platforms.