2017-11-25 20:36:00 +02:00
|
|
|
# INSTALL for Carla
|
2013-01-19 18:43:37 +02:00
|
|
|
|
2020-12-16 14:40:56 +02:00
|
|
|
NOTE: when using MSYS2 on Windows, an additional step is necessary in order
|
|
|
|
to solve an issue with symbolic links to some dependency folders before build:
|
|
|
|
```
|
|
|
|
$ make msys2fix
|
|
|
|
```
|
|
|
|
|
2017-11-25 20:36:00 +02:00
|
|
|
To install Carla, simply run as usual:
|
|
|
|
```
|
|
|
|
$ make
|
|
|
|
$ [sudo] make install
|
|
|
|
```
|
2013-01-19 18:43:37 +02:00
|
|
|
|
2017-11-25 20:36:00 +02:00
|
|
|
You can run it without installing, by using instead:
|
|
|
|
```
|
|
|
|
$ make
|
2018-10-14 23:35:58 +03:00
|
|
|
$ ./source/frontend/carla
|
2017-11-25 20:36:00 +02:00
|
|
|
```
|
2013-01-19 18:43:37 +02:00
|
|
|
|
2017-11-25 20:36:00 +02:00
|
|
|
Packagers can make use of the `PREFIX` and `DESTDIR` variable during install, like this:
|
|
|
|
```
|
|
|
|
$ make install PREFIX=/usr DESTDIR=./test-dir
|
|
|
|
```
|
2013-01-19 18:43:37 +02:00
|
|
|
|
2017-11-25 20:36:00 +02:00
|
|
|
## BUILD DEPENDENCIES
|
2013-01-19 18:43:37 +02:00
|
|
|
|
2019-03-13 02:31:47 +02:00
|
|
|
There are no required build dependencies. The default build is probably not what you want though.
|
2013-01-19 18:43:37 +02:00
|
|
|
|
2019-03-13 02:31:47 +02:00
|
|
|
If you want the frontend (which is likely), you will need PyQt5 (python3 version).
|
2019-01-13 16:23:50 +02:00
|
|
|
|
|
|
|
You likely will also want:
|
2015-01-15 14:03:56 +02:00
|
|
|
|
2019-02-10 01:30:53 +02:00
|
|
|
- libmagic/file (for auto-detection of binary types, needed for plugin-bridges)
|
|
|
|
- liblo (for OSC support, also a requirement for DSSI UIs)
|
2015-01-15 14:03:56 +02:00
|
|
|
|
|
|
|
Optional for extra Linux-only engine features:
|
|
|
|
|
|
|
|
- ALSA
|
|
|
|
- PulseAudio
|
2019-02-10 01:30:53 +02:00
|
|
|
- X11 (LV2/VST X11 UI support)
|
2015-01-15 14:03:56 +02:00
|
|
|
|
|
|
|
Optional for extended LV2 UIs support: (Linux only)
|
2013-01-19 18:43:37 +02:00
|
|
|
|
|
|
|
- Gtk2
|
|
|
|
- Gtk3
|
2013-10-24 22:27:52 +03:00
|
|
|
- Qt4
|
2014-08-23 21:45:05 +03:00
|
|
|
- Qt5
|
2013-01-19 18:43:37 +02:00
|
|
|
|
2022-04-21 21:17:08 +03:00
|
|
|
Optional for Linux VST3 support:
|
|
|
|
|
|
|
|
- freetype2
|
|
|
|
- Xcursor
|
|
|
|
- Xext
|
|
|
|
|
2013-07-02 05:27:06 +03:00
|
|
|
Optional for extra samplers support:
|
2013-01-19 18:43:37 +02:00
|
|
|
|
2018-08-19 11:29:36 +03:00
|
|
|
- FluidSynth (SF2/3)
|
2013-01-19 18:43:37 +02:00
|
|
|
|
2018-08-19 11:29:36 +03:00
|
|
|
Optional for extra LADSPA plugin information:
|
2013-01-19 18:43:37 +02:00
|
|
|
|
2018-08-19 11:29:36 +03:00
|
|
|
- python3-rdflib
|
2013-01-19 18:43:37 +02:00
|
|
|
|
2013-07-02 05:27:06 +03:00
|
|
|
|
2017-11-25 20:36:00 +02:00
|
|
|
You can use:
|
|
|
|
```
|
|
|
|
$ make features
|
|
|
|
```
|
2013-07-02 05:27:06 +03:00
|
|
|
To find out which dependencies are missing.
|
2018-08-19 11:29:36 +03:00
|
|
|
|
|
|
|
|
2019-03-13 02:31:47 +02:00
|
|
|
Under Debian based systems, you can use this command to install everything:
|
2018-08-19 11:29:36 +03:00
|
|
|
```
|
|
|
|
sudo apt install python3-pyqt5.qtsvg python3-rdflib pyqt5-dev-tools \
|
2022-04-21 21:17:08 +03:00
|
|
|
libmagic-dev liblo-dev libasound2-dev libpulse-dev libx11-dev libxcursor-dev libxext-dev \
|
2018-08-19 11:29:36 +03:00
|
|
|
libgtk2.0-dev libgtk-3-dev libqt4-dev qtbase5-dev libfluidsynth-dev
|
|
|
|
```
|
2018-08-19 13:16:25 +03:00
|
|
|
|
2019-02-10 01:30:53 +02:00
|
|
|
Under Fedora, you can use the following command instead:
|
|
|
|
```
|
|
|
|
sudo dnf install python3-qt5-devel python3-rdflib \
|
|
|
|
file-devel liblo-devel alsa-lib-devel pulseaudio-libs-devel libX11-devel
|
|
|
|
gtk2-devel gtk3-devel qt4-devel qt5-devel fluidsynth-devel libsndfile-devel
|
|
|
|
```
|
|
|
|
|
2019-03-13 02:31:47 +02:00
|
|
|
## BUILD BRIDGES (Experimental)
|
2018-08-19 13:16:25 +03:00
|
|
|
|
|
|
|
Carla can make use of plugin bridges to load additional plugin types.
|
|
|
|
|
|
|
|
### 32bit plugins on 64bit systems
|
|
|
|
|
|
|
|
Simply run `make posix32` after a regular Carla build, and install or run Carla locally.<br/>
|
|
|
|
This feature requires a compiler capable of building 32bit binaries.
|
|
|
|
|
|
|
|
### JACK Applications inside Carla
|
|
|
|
|
|
|
|
This is built by default on Linux systems.<br/>
|
|
|
|
Requires LD_PRELOAD support by the OS and the GCC compiler.<br/>
|
|
|
|
Does not work with clang. (if you discover why, please let me know!)
|
|
|
|
|
|
|
|
### Windows plugins (via Wine)
|
|
|
|
|
|
|
|
Requires a mingw compiler, and winegcc.
|
|
|
|
|
|
|
|
First, we build the Windows bridges using mingw, like this: (adjust as needed)
|
|
|
|
```
|
|
|
|
make win32 CC=i686-w64-mingw32-gcc CXX=i686-w64-mingw32-g++
|
|
|
|
make win64 CC=x86_64-w64-mingw32-gcc CXX=x86_64-w64-mingw32-g++
|
|
|
|
```
|
|
|
|
|
|
|
|
To finalize, we build the wine<->native bridges using winegcc:
|
|
|
|
```
|
|
|
|
make wine32
|
|
|
|
make wine64
|
|
|
|
```
|
2019-03-13 02:31:47 +02:00
|
|
|
|
|
|
|
Then install or run Carla locally as usual.<br/>
|
|
|
|
Don't forget to enable experimental options and plugin bridges in Carla settings to actually be able to use them.
|