Open e2sSample.all Library Editor (Oe2sSLE) for Electribe Sampler

This is an editor for electribe sampler (e2s) sample library. It allows library management and supports sample loops and slices editing. You can also remove or replace factory samples with your own.

This code was developed for python 3.6, but shall be compatible with python 3.5 and 3.4. Graphical user interface is using tkinter to reduce external dependencies. The only requirement is pyaudio for audio sample listening (tested with pyaudio v0.2.11):

pip install pyaudio

run the application with

python Oe2sSLE_GUI.py

This application is still under development, so if you encounter a bug, do not hesitate to report it as a new Issue.

For this, if possible try to reproduce the bug, then delete (or rename) the log file, then reproduce the bug one more time and attach (or copy/paste content of) the new created (clean) log file to the description of the Issue.

The log file should be located in ~/.Oe2sSLE/Oe2sSLE.log (<your drive letter>:\\Users\\<your username>\\.Oe2sSLE\\Oe2sSLE.log on windows).

For Mac OS X Users

If you want to run the application directly from the source, there are know issues when you use tkinter (Tcl/Tk python wrapper) for GUI development on Mac OS X. If you follow the next steps, it should work:

• First you will need to install a Tcl/Tk distribution that is more recent than the one provided in Mac OS. It is recommended to install ActiveTcl 8.5.18.0 from Active State web site.
• Then it is recommended to install the official python 3.5.3 distribution from python web site.

For more details on the issue, see this page.

Some screenshots:

Screen shot of the main interface window

Screen shot of the sample loop/sclices edition window: editing area for sample's and slices points

Screen shot of the sample loop/sclices edition window: editing area for slices tempo

Quick documentation:

The Oe2sSLE (Open e2sSample.all Library Editor) is an application editing an e2sSample.all file (a sample library).

1. Basics

1.1 Open

The sample library is empty when the application starts. Use the Open button of the application if you want to edit an existing library, previously saved by the application, or exported by the electribe sampler using DATA UTILITY/EXPORT ALL SAMPLE (in which case it is in the KORG/electribe sampler/Sample/ of the SD card, with the name e2sSample.all).

When you use Open button, unsaved work will be lost. Don't forget to save your work before using Open.

1.2 Save As

At any time you can save your work (the edited sample library) with the Save As button.

You can then put the sample library file onto an SD card:

• into the KORG/electribe sampler/Sample/ directory of the SD card, with the e2sSample.all filename; thus the sample library will be loaded by the electribe sampler when it boots. Note that it is also the location where the electribe sampler exports the e2sSample.all file. If you do DATA UTILITY/EXPORT ALL SAMPLE from the electribe sampler menu, you will erase your file.
• in a folder of your choice, with the name of your choice (you must use the '.all' extension); then you will be able to import it with the electribe sampler from DATA UTILITY/IMPORT SAMPLE menu. Note that the file names are displayed by the electribe sampler without the file extension ('foo.all' file will be displayed as 'foo'). This is the same for classical WAV files: the '.wav' extension is not displayed. So, preferably do not use the same name for a WAV file and for your sample library, as it could be confusing.

Do not forget to save frequently, as the software may still contain some bugs. Also we recommend to make backups of your work, as the life of an SD card is limited.

1.3 Remove samples from the library

1.3.1 Clear all

If you want to completely clear the edited sample library (i.e. remove all the samples), use the Clear all button.

When you use Clear all button, unsaved work will be lost. Don't forget to save your work before using Clear all.

1.3.2 Delete individual samples

If you want to delete a specific sample, use the 'delete' button of the corresponding sample.

You can't undo the delete operation.

1.4 Import samples

1.4.1 Import wav Sample(s)

In order to import and add existing samples contained into WAV files, use the Import wav Sample(s) button.

Imported samples will be attributed the first free sample number starting from From #Num (default is 19) as specified in the Import Options (see Import Options section).

1.4.2 Import samples of a sample library file

In order to import and add to your library all the samples contained in an existing sample library file, you can use the Import e2sSample.all button.

When a sample library is imported (not opened) the original sample numbers will not be kept. Instead, each sample (taken in the same order as in the library file) will be attributed the first free sample number starting from From #Num (default is 19) as specified in the Import Options (see Import Options section).

1.4.3 Import a single sample to replace an existing one

If you want to import a sample to replace an existing one, use the 'import replacement sample' button corresponding to the sample to be replaced.

After a sample has been replaced by another one, it is lost. You can't undo the operation.

1.4.4 Import options

If you click on Import Options button, you will open the Import options dialog window.

You can select default values for OSC Cat., 1-shot and +12dB columns (see section 2). This default values are used when an imported sample does not contain this information in its metadata.

You can also force to use these values for any imported sample by checking the associated check-boxes Force to reset.

The Import options dialog window also allow to choose with From #Num from which number a free sample number will be looked for when importing a sample.

When the Force mono checkbox is activated, any imported stereo sample will be automatically converted to mono, using the pan mixing configuration specified by the scroll bar on the right of that checkbox.

1.4.5 Check that your sample library is not exceeding the electribe sampler memory limit.

At the bottom right of the main window, you can see Total data size : , the memory used by your samples as well as the memory limit of electribe sampler. If the limit is reached the used memory will turn red in order to warn you.

1.5 Export samples to WAV files

1.5.1 Export all the samples

If you want to export all the samples of the edited sample library file in individual WAV files, use the Export all as wav button. You will be asked to select a directory in which all the samples will be extracted.

1.5.2 Export individual samples

If you want to export a specific sample, use the 'export sample' button of the corresponding sample.

1.5.3 Export options

If you click on Export Options button, you will open the Export options dialog window.

This dialog allows you to choose if you want to include a smpl chunk in the WAV file to indicate the start/stop/loop points to a DAW (understanding that chunk), for instance.

The dialog also allows to choose if you want to include cue chunks in the WAV file to indicate the slices positions to a DAW (understanding that chunk), for instance. If Export slices info in 'cue ' chunk is checked, a cue chunk will be generated if at least one slice is non empty (has a length greater than zero), and a cue point in that cue chunk will be used for each non empty slice to indicate its start.

1.6 Listen a sample

To listen the WAV content of a specific sample, use the 'play' button of the corresponding sample.

When you play a sample like this the start/stop/loop points are ignored. The content is played from the start to the end of the WAV data. You can stop the playback of the samples by using the 'stop' button on the top of the 'play' buttons.

It is possible to listen the sample in a way closer to how it will be rendered by the electribe sampler (section 3. Advanced sample properties (loop/slices...)).

1.7 Move a sample

On the left side of the sample list there are 'radio' buttons that allow you to select a specific sample. The selected sample can be moved using the buttons on the left of the radio buttons.

1.7.1 Exchange with another

You can exchange the selected sample with another one, using the 'exchange with another' button. You will be asked to select the sample with which you want to exchange the selected one.

1.7.2 Swap up/down

You can swap the