Add footnote on why ~/.local/share over /usr/local

This commit is contained in:
Robbert van der Helm
2020-09-27 13:46:36 +02:00
parent f67e1923cc
commit 1ad9a2b4ab
+15 -5
View File
@@ -83,11 +83,11 @@ comprehensive documentation can be found in yabridgectl's readme, or by running
First of all, yabridgectl needs to know where it can find yabridge's files. If First of all, yabridgectl needs to know where it can find yabridge's files. If
you have downloaded the prebuilt binaries, then you can simply extract the you have downloaded the prebuilt binaries, then you can simply extract the
archive to `~/.local/share` and yabridgectl will pick up the files in archive to `~/.local/share` and yabridgectl will pick up the files in
`~/.local/share/yabridge` automatically. You also won't have to do any `~/.local/share/yabridge` automatically[\*](#why-local-share-yabridge). You also
additional setup if you're using one of the AUR packages. If you have compiled won't have to do any additional setup if you're using one of the AUR packages.
yabridge from source or if you installed the files to some other location, then If you have compiled yabridge from source or if you installed the files to some
you can use `yabridgectl set --path=<path>` to tell yabridgectl where it can other location, then you can use `yabridgectl set --path=<path>` to tell
find the files. yabridgectl where it can find the files.
Secondly, yabridgectl will default to the copy-based installation method. If you Secondly, yabridgectl will default to the copy-based installation method. If you
are using a VST host with individually sandboxed plugins such as Bitwig Studio are using a VST host with individually sandboxed plugins such as Bitwig Studio
@@ -105,6 +105,16 @@ tell your VST host to search for plugins in the directories you just added and
you'll be good to go. Don't forget to rerun `yabridgectl sync` whenever you you'll be good to go. Don't forget to rerun `yabridgectl sync` whenever you
update yabridge if you are using the copy-based installation method. update yabridge if you are using the copy-based installation method.
<sup id="why-local-share-yabridge">
*Instead of copying yabridge's files to <code>~/.local/share</code>, it would
also be possible to install yabridge to <code>/usr/local/bin</code> and
<code>/usr/local/lib</code>. While this does avoid the need to modify your
<code>PATH</code> environment variable when using the copy-based installation
method, it could also cause other issues if you're not careful. This is why
it's recommended to install yabridge to your home directory if you're not
using one of the AUR packages.
</sup>
### Manual setup ### Manual setup
To set up yabridge without using yabridgectl, first download and extract To set up yabridge without using yabridgectl, first download and extract