Audio plugin host https://kx.studio/carla
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

INSTALL.md 2.9KB

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