From 67b288687dd2ae1dd616d6c7db73c13af15d65a6 Mon Sep 17 00:00:00 2001 From: Eoghan Murray Date: Mon, 23 Nov 2020 16:10:05 +0000 Subject: [PATCH] Add more concrete examples I had downloaded the valhalla plugin mentioned, but didn't realize that the `.exe` file wasn't the plugin, but rather an installer for the plugin which needed to executed in the Wine environment to be readable by yabridge. Even the fact that Wine was a prerequisite for yabridge was not initially apparent to me (but would be obvious now). --- README.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/README.md b/README.md index 06961a28..a9888d3c 100644 --- a/README.md +++ b/README.md @@ -15,6 +15,7 @@ highly compatible, while also staying easy to debug and maintain. - [Tested with](#tested-with) - [Usage](#usage) + - [Preliminaries](#preliminaries) - [Automatic setup (recommended)](#automatic-setup-recommended) - [Manual setup](#manual-setup) - [DAW setup](#daw-setup) @@ -57,6 +58,28 @@ Manjaro ([yabridge](https://aur.archlinux.org/packages/yabridge/), [yabridge-bin](https://aur.archlinux.org/packages/yabridge-bin/), [yabridge-git](https://aur.archlinux.org/packages/yabridge-git/)). +### Preliminaries + +YABridge builds upon VST2 plugins installed via Wine. + +The recommended Wine version is the *staging* version installed directly from +WineHQ (your packaged version may be too old): https://wiki.winehq.org/Download +`sudo apt install --install-recommends winehq-staging` + +If you don't have any VST2 plugins installed, download an example one, e.g. +https://valhalladsp.com/shop/reverb/valhalla-supermassive/. Note: you will +need to execute the .exe installer in your Wine environment in order to produce +the VST2 .dll files. + +Yabridge will use the dll file +(e.g. `~/.wine/drive_c/Program Files/Common Files/VST2/ValhallaSupermassive_x64.dll`) +to output a `ValhallaSupermassive_x64.so` file in the same folder, usable in linux. + +After installation, you'll run +`yabridgectl add "~/.wine/drive_c/Program Files/Common Files/VST2/"` +and then access this same folder in your DAW for import (e.g. for BitWig, +add the folder via `Settings > Locations > Plug-in Locations > + Add Location`) . + ### Automatic setup (recommended) The easiest way to get up and running is through