GitPlanet

Cheap and reliable Node.js hosting starts at $3/month, and $1/month static HTML hosting

Created with love in Canada, visit hostnodejs.com today

Feel like to post an Ad? Learn Details
All Projects → dagargo → elektroid

dagargo / elektroid

Licence: GPL-3.0 license
Sample and MIDI device manager

Programming Languages

c
50402 projects - #5 most used programming language
shell
77523 projects

Labels

audiomidihacktoberfest

Projects that are alternatives of or similar to elektroid

patchmaster
MIDI processing and patching system
Stars: ✭ 22 (-82.68%)
Mutual labels:  midi
ofxOscMidi
Midi in, OSC out with Midi thru. Based on openFrameworks
Stars: ✭ 66 (-48.03%)
Mutual labels:  midi
Kazedan
A Synthesia styled MIDI visualization.
Stars: ✭ 18 (-85.83%)
Mutual labels:  midi
onyxite-customs
Toolkit for converting and building songs for Rock Band, Guitar Hero, Clone Hero, and other similar rhythm games
Stars: ✭ 80 (-37.01%)
Mutual labels:  midi
models
Programmatically control Elektron's model:cycles & model:samples via midi using Go.
Stars: ✭ 26 (-79.53%)
Mutual labels:  midi
mpe-player
Browser Based Audio Oscillators using MPE devices & MPE.js
Stars: ✭ 16 (-87.4%)
Mutual labels:  midi
purescript-school-of-music
Port of the Haskell School of Music to Purescript
Stars: ✭ 21 (-83.46%)
Mutual labels:  midi
midi-eye
Ruby MIDI input event listener
Stars: ✭ 24 (-81.1%)
Mutual labels:  midi
CureSynth Whip
Polyphonic MIDI Synthesizer for STM32F7
Stars: ✭ 45 (-64.57%)
Mutual labels:  midi
midibus.js
🚌💨🎶 Web MIDI API wrapper based on themidibus
Stars: ✭ 24 (-81.1%)
Mutual labels:  midi
guitar
🎸 Online guitar toy and tablature recorder/player
Stars: ✭ 80 (-37.01%)
Mutual labels:  midi
esp32 basic synth
ESP32 based simple synthesizer project
Stars: ✭ 134 (+5.51%)
Mutual labels:  midi
midievents
MIDI events parser/encoder.
Stars: ✭ 30 (-76.38%)
Mutual labels:  midi
orca
Lua port of @neauoire orca for monome norns
Stars: ✭ 75 (-40.94%)
Mutual labels:  midi
Raspberry-MIDI-Controller
A python script that sends MIDI signals from the Raspberry (client) to a Computer (host)
Stars: ✭ 44 (-65.35%)
Mutual labels:  midi
Arduino-USBMIDI
Allows a microcontroller, with native USB capabilities, to appear as a MIDI device over USB to a connected computer
Stars: ✭ 98 (-22.83%)
Mutual labels:  midi
digitakt-song-mode
Song mode for Elektron Digitakt
Stars: ✭ 29 (-77.17%)
Mutual labels:  midi
synthrs
Toy audio synthesizer library in Rust with basic MIDI support.
Stars: ✭ 73 (-42.52%)
Mutual labels:  midi
node-keyboard
A REPL where music is simply streams of input in node (using soundfonts). Supports optional MIDI input and Rx.
Stars: ✭ 50 (-60.63%)
Mutual labels:  midi
midi-player
A MIDI player which sends MIDI messages to connected devices.
Stars: ✭ 21 (-83.46%)
Mutual labels:  midi
View All Similar Projects ➔

Elektroid

Elektroid is a sample and MIDI device manager. It includes the elektroid GUI application and the elektroid-cli CLI application.

Supported devices:

  • Elektron Model:Samples
  • Elektron Model:Cycles
  • Elektron Digitakt
  • Elektron Digitone and Digitone Keys
  • Elektron Syntakt
  • Elektron Analog Rytm MKI and MKII
  • Elektron Analog Four MKI, MKII and Keys
  • All samplers implementing MIDI SDS
  • Casio CZ-101 presets
  • Arturia MicroBrute sequences
  • Eventide ModFactor, PitchFactor, TimeFactor, Space and H9 presets

To use with Elektron devices, USB configuration must be set to USB MIDI or USB AUDIO/MIDI as it won't work in Overbridge mode.

Compilation and 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 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 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, 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 will install the build dependencies.

For Arch Linux, sudo pacman -S base-devel autoconf libtool alsa-lib zlib libzip gtk3 libsndfile gettext libsamplerate pulseaudio json-glib will install the build dependencies.

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 server

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).

Packaging

This is a quick glance at the instructions needed to build some distribution packages.

Debian

$ dpkg-buildpackage -b -rfakeroot -us -uc

Fedora

$ rel=35
$ mock -r fedora-$rel-x86_64 --buildsrpm --spec elektroid.spec --sources .
$ mock -r fedora-$rel-x86_64 --no-clean --rebuild /var/lib/mock/fedora-$rel-x86_64/result/elektroid-*.src.rpm

CLI

elektroid-cli brings the same functionality as elektroid to the command line.

There are device commands and filesystem commands. The latter have the form a-b-c where a is a connector, b is a filesystem and c is the command, (e.g., elektron-project-ls, cz-program-upload, sds-sample-download). Notice that the filesystem is always in the singular form. As of version 2.2, older command forms have been removed.

These are the available commands:

  • ls or list
  • mkdir (behave as mkdir -p)
  • rmdir or rm (both behave as rm -rf)
  • mv (in slot mode, the second path is just the name of the file)
  • cp
  • cl, clear item
  • sw, swap items
  • ul or upload
  • dl or download

Keep in mind that not every filesystem implements all the commands. For instance, Elektron samples can not be swapped.

Provided paths must always be prepended with the device id and a colon (e.g., 0:/incoming). In slot mode filesystems, (these are the most typically used), items are addressed by number and destination paths take the form path:name (e.g., 0:/0:bass) when uploading.

Device commands

  • ld or ls-devices, list all MIDI devices with input and output
$ elektroid-cli ld
0: hw:2,0,0 Elektron Digitakt MIDI 1
1: hw:4,0,0 padKONTROL MIDI 1
2: hw:4,0,1 padKONTROL MIDI 2
  • info or info-device, show device info including device filesystems
$ elektroid-cli info 0
Digitakt 1.30 (Digitakt) filesystems=sample,data,project,sound
  • df or info-storage, show size and use of +Drive and RAM
$ elektroid-cli df 0
Storage               Size            Used       Available       Use%
+Drive           959.50MiB       198.20MiB       761.30MiB     20.66%
RAM               64.00MiB        13.43MiB        50.57MiB     20.98%
  • send and receive work with a batch of SysEx messages. These are useful when working with generic devices, which have no filesystems implemented buf offer options to receive or send data.
$ elektroid-cli send file.syx 0:/
$ elektroid-cli receive 0:/
  • upgrade, upgrade firmware
$ elektroid-cli upgrade Digitakt_OS1.30.syx 0

Elektron conector

These are the available filesystems for the elektron connector:

  • sample
  • raw
  • preset
  • data
  • project
  • sound

Raw and data are intended to interface directly with the filesystems provided by the devices so the downloaded or uploaded files are not compatible with Elektron Transfer formats. Preset is a particular instance of raw and so are project and sound but regarding data. Thus, raw and data filesystems should be used only for testing and are not available in the GUI.

Sample, raw and preset commands

  • elektron-sample-ls

It only works for directories. Notice that the first column is the file type, the second is the size, the third is an internal cksum and the last one is the sample name.

$ elektroid-cli elektron-sample-ls 0:/
D              0B 00000000 drum machines
F       630.34KiB f8711cd9 saw
F         1.29MiB 0bbc22bd square
  • elektron-sample-mkdir
$ elektroid-cli elektron-sample-mkdir 0:/samples
  • elektron-sample-rmdir
$ elektroid-cli elektron-sample-rmdir 0:/samples
  • elektron-sample-ul
$ elektroid-cli elektron-sample-ul square.wav 0:/
  • elektron-sample-dl
$ elektroid-cli elektron-sample-dl 0:/square
  • elektron-sample-mv
$ elektroid-cli elektron-sample-mv 0:/square 0:/sample
  • elektron-sample-rm
$ elektroid-cli elektron-sample-rm 0:/sample

Data, sound and project commands

There are a few things to clarify first.

  • All data commands are valid for both projects and sounds although the examples use just sounds.

  • All data commands that use paths to items and not directories use the item index instead the item name.

Here are the commands.

  • elektron-data-ls

It only works for directories. Notice that the first column is the file type, the second is the index, the third is the permissons in hexadecimal, the fourth indicates if the data in valid, the fifth indicates if it has metadatam, the sixth is the size and the last one is the item name.

Permissions are 16 bits values but only 6 are used from bit 2 to bit 7 both included. From LSB to MSB, this permissions are read, write, clear, copy, swap, and move.

$ elektroid-cli elektron-data-ls 0:/
D  -1 0000 0 0         0B projects
D  -1 0000 0 0         0B soundbanks

$ elektroid-cli elektron-data-ls 0:/soundbanks/D
F   1 0012 1 1       160B KICK
F   2 0012 1 1       160B SNARE
  • elektron-data-cp
$ elektroid-cli elektron-data-cp 0:/soundbanks/D/1 0:/soundbanks/D/3
$ elektroid-cli elektron-data-ls 0:/soundbanks/D
F   1 0012 1 1       160B KICK
F   2 0012 1 1       160B SNARE
F   3 0012 1 1       160B KICK
  • elektron-data-sw
$ elektroid-cli elektron-data-sw 0:/soundbanks/D/2 0:/soundbanks/D/3
$ elektroid-cli elektron-data-ls 0:/soundbanks/D
F   1 0012 1 1       160B KICK
F   2 0012 1 1       160B KICK
F   3 0012 1 1       160B SNARE
  • elektron-data-mv
$ elektroid-cli elektron-data-mv 0:/soundbanks/D/3 0:/soundbanks/D/1
$ elektroid-cli elektron-data-ls 0:/soundbanks/D
F   1 0012 1 1       160B SNARE
F   2 0012 1 1       160B KICK
  • elektron-data-cl
$ elektroid-cli elektron-data-cl 0:/soundbanks/D/1
$ elektroid-cli elektron-data-ls 0:/soundbanks/D
F   2 0012 1 1       160B KICK
  • elektron-data-dl
$ elektroid-cli elektron-data-dl 0:/soundbanks/D/1
  • elektron-data-ul
$ elektroid-cli elektron-data-ul sound 0:/soundbanks/D

Adding and reconfiguring Elektron devices

Since version 2.1, it is possible to add and reconfigure devices without recompiling as the device definitions are stored in a JSON file. 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": "Digitakt",
        "alias": "dt",
        "filesystems": 57,
        "storage": 3
}, {

Properties filesystems and storage are based on the definitions found in src/connectors/elektron.h and are the bitwise OR result of all the supported filesystems and storage types.

enum connector_fs
{
  FS_SAMPLES = 0x1,
  FS_RAW_ALL = 0x2,
  FS_RAW_PRESETS = 0x4,
  FS_DATA_ALL = 0x8,
  FS_DATA_PRJ = 0x10,
  FS_DATA_SND = 0x20,
};

enum connector_storage
{
  STORAGE_PLUS_DRIVE = 0x1,
  STORAGE_RAM = 0x2
};

If the file ~/.config/elektroid/elektron-devices.json is found, it will take precedence over the installed one.

Running tests

Elektroid includes automated integration tests for the supported devices and filesystems.

In order to run a test, proceed as follows. The variable TEST_DEVICE must contain the device id and variable TEST_CONNECTOR_FILESYSTEM must contain the connector name, an underscore char (_) and the filesystem name.

$ TEST_DEVICE=0 TEST_CONNECTOR_FILESYSTEM=efactor_preset make check

Running make check without setting any of these variables will succeed and no test will be ran.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].