table of contents
| ELEKTROID-CLI(1) | General Commands Manual | ELEKTROID-CLI(1) |
NAME¶
elektroid-cli - Sample and MIDI device manager (CLI)
SYNOPSIS¶
elektroid-cli [options] command
DESCRIPTION¶
elektroid-cli is part of Elektroid, a sample and MIDI device manager. See man elektroid for the GUI application.
With Elektroid you can easily upload and download audio files and manage different types of data on different MIDI devices, such as presets, projects or tunings. It can also be used to send and receive SysEx MIDI files.
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
- •
- Arturia MicroBrute
- •
- Eventide ModFactor, PitchFactor, TimeFactor, Space and H9
- •
- Moog Little Phatty and Slim Phatty
- •
- Novation Summit and Peak
DEVICE COMMANDS¶
Device commands operate over the device itself. For the commands that operate over the different types of data a device provides see the filesystem commands section.
- [ ld | list-devices ]
- List compatible devices
- [ df | info-storage ] device_number
- Show size and use of +Drive and RAM where available
- info device_number
- Show device info
- upgrade firmware device_number
- Upgrade the device
FILESYSTEM COMMANDS¶
Different filesystem operations are implemented on different connectors so a command has the following form:
- connector, hyphen ('-'), filesystem name, hyphen ('-'), and the operation itself
- Provided paths must always be prepended with the device id and a colon (':'), e.g. 0:/samples. Paths pointing to a data, sound or project file use the index of a file instead of its name.
- These are the available operations.
- [ ls | list ] device_number:path_to_directory
- List directory contents
- mkdir device_number:path_to_directory
- Create a directory and its parent directories as needed
- [ rmdir | rm ] device_number:path_to_directory
- Delete a directory recursively
- [ ul | upload ] file device_number:path_to_file_or_directory
- Upload a file. If the path does not exist it will be created. For the sample filesystem, the supported audio file formats are aiff, flac, ogg and wav.
- [ dl | download ] device_number:path_to_file_or_directory
- Download a file into the current directory. For the sample filesystem, samples will be stored locally as 16-bit, 48kHz wav files.
- mv device_number:path_to_file_or_directory device_number:path_to_file_or_directory
- Move a file. If the destination path does not exist, it will be created.
- rm device_number:path_to_file
- Delete a file
- cl device_number:path_to_file
- Clear file
- cp device_number:path_to_file device_number:path_to_file
- Copy a file
- sw device_number:path_to_file device_number:path_to_file
- Swap files
OPTIONS¶
EXAMPLES¶
- elektroid-cli ld
- lists the available devices.
- elektroid-cli info 0
- shows information about the device, including the connector and the available filesystems.
- elektroid-cli elektron-sample-ul square.wav 0:/waveforms
- uploads a sample to an Elektron device.
- elektroid-cli sds-mono16-dl 0:/1
- downloads a mono 16 bits sample from an SDS sampler.
- elektroid-cli summit-single-ls 0:/A
- lists Novation Summit single patches in bank A.
SEE ALSO¶
The GitHub page provides some examples: <https://github.com/dagargo/elektroid>
AUTHOR¶
elektroid-cli was written by David García Goñi <dagargo@gmail.com>.
This manual page was written by Dennis Braun <snd@debian.org> for the Debian project (but may be used by others).
| Jan 2023 |