Installation
As with other autotools project, you need to run the following commands. If you just want to compile elektroid-cli
, pass CLI_ONLY=yes
to ./configure
.
autoreconf --install
./configure
make
sudo make install
The package dependencies for Debian-based distributions are:
- automake
- libtool
- build-essential
- libasound2-dev
- libgtk-3-dev
- libpulse-dev
- libsndfile1-dev
- libsamplerate0-dev
- autopoint
- gettext
- zlib1g-dev
- libjson-glib-dev
- libzip-dev
You can easily install them by running this.
sudo apt install automake libtool build-essential libasound2-dev libgtk-3-dev libpulse-dev libsndfile1-dev libsamplerate0-dev autopoint gettext zlib1g-dev libjson-glib-dev libzip-dev`
If you are only compiling the CLI, install the dependencies with this.
sudo apt install automake libtool build-essential libasound2-dev libglib2.0-dev libsndfile1-dev libsamplerate0-dev autopoint libtool zlib1g-dev libjson-glib-dev libzip-dev
For Fedora, run this to install the build dependencies.
sudo dnf install autoconf libtool alsa-lib-devel zlib-devel libzip-devel gtk3-devel libsndfile-devel gettext-devel libsamplerate-devel pulseaudio-libs-devel json-glib-devel
For Arch Linux, run this to install the build dependencies.
sudo pacman -S base-devel autoconf libtool alsa-lib zlib libzip gtk3 libsndfile gettext libsamplerate json-glib`
For OSX (Homebrew), run this to install the build dependencies.
homebrew install automake bltool pkg-config gtk+3 libsndfile libsamplerate gettext zlib json-glib libzip rtaudio rtmidi
For MSYS2 (UCRT64), run this to install the build dependencies.
pacman -S mingw-w64-x86_64-toolchain gettext gettext-devel libtool pkg-config mingw-w64-x86_64-autotools mingw-w64-x86_64-gcc mingw-w64-ucrt-x86_64-zlib mingw-w64-ucrt-x86_64-libzip mingw-w64-ucrt-x86_64-gtk3 mingw-w64-x86_64-json-glib mingw-w64-ucrt-x86_64-libsndfile mingw-w64-ucrt-x86_64-rtmidi mingw-w64-ucrt-x86_64-rtaudio mingw-w64-ucrt-x86_64-libsamplerate
Additional notes on MSYS2 (UCRT64)
- Repository must be cloned with
-c core.symlinks=true
option for the included symbolic links to work. LANG
environmente variable must be set as inLANG=es_ES.UTF-8
depending on your installed locales.- A shortcut could be manually created and use the
ico
file included in the installation for this purpose. It is recommended to set thetarget
property toC:\msys64\usr\bin\mintty.exe -w hide /bin/env MSYSTEM=UCRT64 LANG=es_ES.UTF-8 /bin/bash -l -i -c /ucrt64/bin/elektroid.exe
and thestart in
property toC:\msys64\usr\bin
or the equivalent directories in your installation.
MIDI backend
By default, Elektroid uses ALSA as the MIDI backend on Linux and RtMidi on other OSs. To use RtMidi on Linux, pass RTMIDI=yes
to ./configure
. In this case, the RtMidi development package will be needed (librtmidi-dev
on Debian).
Audio backend
By default, Elektroid uses PulseAudio as the audio server on Linux and RtAudio on other OSs. To use RtAudio on Linux, pass RTAUDIO=yes
to ./configure
. In this case, the RtAudio development package will be needed (librtaudio-dev
on Debian).
Adding and reconfiguring Elektron devices
It is possible to add and reconfigure Elektron devices without recompiling as the device definitions are first searched within the ~/.config/elektroid/elektron/devices.json
JSON file. If the file is not found, the installed one will be used. Hopefully, this approach will make it easier for users to modify and add devices and new releases will only be needed if new funcionalities are actually added.
This is a device definition from res/elektron/devices.json
.
{
"id": 12,
"name": "Elektron Digitakt",
"filesystems": {
"sample": null,
"data": null,
"project": [
"dtprj"
],
"sound": [
"dtsnd"
]
},
"storage": [
"+Drive",
"RAM"
]
}
The list represents the allowed file extensions for the given filesystem.