Jump to content

# Audio plugins package guidelines

From ArchWiki

This document covers proposed standards and guidelines on writing PKGBUILDs for plugins for Professional audio.

Note:

- The package name should be entirely lowercase.
- Ultimately there is no hard rule for naming, i.e. these are only guidelines. In general, naming follows upstream.

## Destination directory and naming rules

Plugin format | Package naming | Destination directory | File naming | Directory naming | Groups | Optdepends
--- | --- | --- | --- | --- | --- | ---
CLAP | `name-clap` | /usr/lib/clap/ | `name.clap` | `name.clap` | `pro-audio clap-plugins` | `clap-host`
DSSI | `name-dssi` | /usr/lib/dssi/ | `name-dssi.so` | `name-dssi` | `pro-audio dssi-plugins` | `dssi-host`
LADSPA | `name-ladspa` | /usr/lib/ladspa/ | `name-ladspa.so` | `name-ladspa` | `pro-audio ladspa-plugins` | `ladspa-host`
LV2 | `name-lv2` | /usr/lib/lv2/ |  | `name.lv2` | `pro-audio lv2-plugins` | `lv2-host`
VCV Rack | `vcvrack-name` | /usr/lib/vcvrack/plugins/ |  | `name` | `pro-audio vcvrack-plugins` |
VST 2 | `name-vst` | /usr/lib/vst/ | `name.so` | `name.vst` | `pro-audio vst-plugins` | `vst-host`
VST 3 [1] | `name-vst3` | /usr/lib/vst3/ | `name.so` | `name.vst3` | `pro-audio vst3-plugins` | `vst3-host`

## Package description

The package description should at least contain the word `plugin` and what type of plugin it is: `CLAP`, `DSSI`, `LADSPA`, `LV2`, `VCV Rack`, `VST2`, `VST3`.

## Windows plugins

Some plugins, which are not available in a native Linux version, but are available for Windows, can be used on Linux via Wine and yabridge or other bridging solutions,

Also read the Wine package guidelines.

Architecture | Plugin format | Package naming | Destination directory | File naming | Directory naming | Application data | Groups | Optdepends
--- | --- | --- | --- | --- | --- | --- | --- | ---
x86_64 | CLAP | `name-clap-x86_64-windows` | /usr/lib/wine/x86_64-windows/clap/ | `name.clap` | `name.clap` | /usr/share/wine/clap/ | `pro-audio clap-plugins-x86_64-windows` | `clap-host wine-staging yabridge`
x86_64 | VST 2 | `name-vst-x86_64-windows` | /usr/lib/wine/x86_64-windows/vst/ | `name.dll` | `name.vst` | /usr/share/wine/vst/ | `pro-audio vst-plugins-x86_64-windows` | `vst-host wine-staging yabridge`
x86_64 | VST 3 [2] | `name-vst3-x86_64-windows` | /usr/lib/wine/x86_64-windows/vst3/ | `name.vst3` | `name.vst3` | /usr/share/wine/vst3/ | `pro-audio vst3-plugins-x86_64-windows` | `vst3-host wine-staging yabridge`
i386 | CLAP | `name-clap-i386-windows` | /usr/lib32/wine/i386-windows/clap/ | `name.clap` | `name.clap` | /usr/share/wine/clap/ | `pro-audio clap-plugins-i386-windows` | `clap-host wine-staging yabridge`
i386 | VST 2 | `name-vst-i386-windows` | /usr/lib32/wine/i386-windows/vst/ | `name.dll` | `name.vst` | /usr/share/wine/vst/ | `pro-audio vst-plugins-i386-windows` | `vst-host wine-staging yabridge`
i386 | VST 3 [3] | `name-vst3-i386-windows` | /usr/lib32/wine/i386-windows/vst3/ | `name.vst3` | `name.vst3` | /usr/share/wine/vst3/ | `pro-audio vst3-plugins-i386-windows` | `vst3-host wine-staging yabridge`

### Package description

The package description should at least contain the word `Windows`, `plugin` and what type of plugin it is: `CLAP`, `VST2`, `VST3`.

Category:

- Arch package guidelines