Help & Documentation
Installation
EP Toolkit is available for Windows 10+, macOS 12+ (Intel and Apple Silicon), and Linux. Download the latest version from the homepage.
- Windows: the
.exeinstaller is unsigned. So expect a warning from SmartScreen. Alternatively, you can install EP Toolkit directly from the Microsoft Store. - macOS: open the
.dmgand drag EP Toolkit to your Applications folder. - Linux: download the
.AppImageand make it executable withchmod +x EPToolkit-X.X.X-x86_64.AppImage, then run it.
Connection
EP Toolkit communicates with Teenage Engineering devices via MIDI SysEx over USB. The app automatically detects your device when it’s connected.
Supported devices:
EP-133 K.O. II (64mb and 128mb versions)
EP-1320 Medieval
EP-40 Riddim
The connection status is shown at the bottom of the sidebar: a orange dot means connected, and a gray dot means not connected. When connected, the status bar also shows the device name and firmware version.
Troubleshooting
- Make sure your device is powered on and connected via a USB data cable (charge-only cables won’t work). Also avoid cheap USB hubs or cables of questionable quality.
- Close other MIDI apps - DAWs, MIDI editors, or similar software can prevent EP Toolkit from detecting your device.
- Try unplugging other MIDI controllers or interfaces, as having multiple MIDI devices connected can sometimes cause conflicts.
- Open and close the app, or try restarting the device while the app is open.
Projects
The Projects page shows all 9 project slots on your device in a grid layout. The page header contains three action buttons:
- Backup all projects - creates a full device backup (
.pak), fully compatible with EP Sample Tool. On the first backup, the app will ask for the backup folder location. You can change this later in Settings. - Load from backup - opens a saved backup file to view projects and samples. Supports
.ppakfor single projects and.pakfor full device backups. - Download all projects - downloads all 9 projects from the device to app memory one by one. It will take about 10 seconds, so be patient.
Project Card
Each project card represents one project slot on your device and shows the following information:

Each card has four action buttons:
- Reload - re-downloads the project data from the device. Useful if you have made changes on the device and want to refresh the project in the app.
- Backup - saves this single project as a
.ppakfile. - Edit - opens the project editor to edit scenes and patterns.
- Export - opens the export page to convert the downloaded project to a DAW format. The Export button is only available after the project has been downloaded or when a project was loaded from a backup.
Playing a project
Click the small play button in the top-left corner of a downloaded project card. It plays the scenes in order, and the button turns into a stop button.

The scene strip shows where you are. Click a scene to play from there, or drag the strip sideways if there are too many scenes to fit.
Samples may take a moment to load first. Playback comes from your computer, not the EP, so it may sound a bit different. It uses the saved project, not unsaved changes in the editor.
Project Editor
Click Edit on a downloaded project card. You can put scenes in a different order and choose the patterns each group plays. This isn’t a note editor - you’re working with the patterns already in the project.
Scene grid
Each column is a scene, and the four rows are groups A, B, C, and D. A01, B02, and so on are the patterns assigned to that scene. The little note previews help you tell them apart. Scroll sideways to see more scenes.

Picking patterns and moving scenes
Click a block in the grid, then click a pattern in the list on the right to use it. The A/B/C/D buttons switch groups. Use the small play buttons to hear a pattern, or the one beside the scene name to hear the whole scene.
The buttons below the list work on the selected scene:
- Move left / Move right - move it one place in the order.
- Duplicate next puts a copy right after it. Duplicate last puts the copy at the end. Both make separate copies of the patterns too.
- Add empty inserts a blank scene after this one.
- Remove deletes the scene, but keeps its patterns. You can still use them in another scene.

Saving and undoing

Nothing is sent to the device until you click Save to device. If you opened a backup, the button says Save to backup file instead.
Undo (Ctrl/Cmd+Z) takes back one edit. Discard takes you back to the last saved version. Reload downloads the project from the device again.
At the bottom, Renumber scenes closes gaps in scene numbers, and Remove unused patterns deletes patterns no scene uses. Clear all leaves one empty scene and clears the patterns, but keeps your pads and project settings.
Export
Export your EP projects to popular DAW formats. Click Export on a downloaded project card to open the export page.
Supported formats:
Ableton Live 11+ - Simpler instruments with samples, envelopes, Drum Rack support, session clips or arrangement, grouped tracks, fader automation, scene names, and FX return tracks.
DAWproject (Bitwig, Cubase, etc.) - arrangement with clips and notes, scene/clip launcher, per-track volume/pan, samples in folder.
Standard MIDI - SMF Type 1 with per-pad tracks, tempo, time signature, velocity, CC automation, samples in folder.
REAPER - arrangement with ReaSamplOmatic5000 sampler instruments, MIDI items, track grouping.
DAW Settings
Each format has specific options you can configure before exporting:
- Project name and export folder - where to save the output.
- Create project folder - a subfolder with the project name will be created inside the export folder, and all files will be saved there. If disabled, files will be saved directly to the export folder.
- Include samples - downloads samples from the device and bundles them with the export.
- Drum Rack (Ableton) / Merge tracks - combine all pads in a group into a single drum instrument track. In this mode all notes will be spread across the same track, with different MIDI notes triggering different samples. Make sure that pads in the merged group are not played chromatically (KEY mode).
- Session clips - export to session/launcher view instead of arrangement timeline.
- Group tracks - organize tracks into groups by pad group (A/B/C/D). In this mode fader automation will be applied to a group, not individual tracks.
- Send effects - include return tracks with delay, reverb, distortion, chorus, filter, and compressor effects mapped from the device. This is different from how effect bus works on the device, where the fader controls dry/wet mix of the effect. In the exported project, the effect will be on a separate return track with 100% wet mix, and the fader automation will control the send level to that track.

Arrangement
The arrangement view lets you review and customize the export before generating files:
- Scenes - select which scenes to include and rename them.
- Tracks - enable/disable individual tracks, rename them, and assign colors using the Ableton color palette. Click on the pad badge to open the color picker.


Device Parameters (Faders)
Each device group (A/B/C/D) can have up to 12 fader parameters. Static values are baked into the exported project as initial settings. If a fader is automated (recorded fader movements), automation envelopes are generated for each format (except REAPER).
| Parameter | Ableton Live | DAWproject | MIDI | REAPER |
|---|---|---|---|---|
| LVL | Track Volume | Track Volume | CC 7 | Track VOLPAN |
| PAN | Track Pan | Track Pan | CC 10 | Track VOLPAN |
| PTC | Simpler Transpose | Transpose | - | - |
| TUN | Simpler Fine Tune | CC 76 | CC 76 | - |
| LPF | Simpler Filter Freq | CC 74 (Cutoff) | CC 74 | - |
| HPF | Simpler Filter Freq | CC 71 | CC 71 | - |
| FX | Track Send Level | CC 91 (Reverb Send) | CC 91 | - |
| ATK | Simpler Attack Time | CC 73 | CC 73 | VST state |
| REL | Simpler Release Time | CC 72 | CC 72 | VST state |
| MOD | Simpler Pitch LFO | CC 1 (Mod Wheel) | CC 1 | - |
| VEL | Note Velocity | CC 107 | CC 107 | - |
| TIM | - | CC 105 | CC 105 | - |
Samples
The Samples page has a dual-panel layout: local files on the left, device samples on the right.
Left Panel (Local Files)
Open a folder to browse WAV, MP3, FLAC, OGG, AIFF, and M4A/MP4 audio. The app scans up to 16 folder levels and skips files larger than 128 MiB.
- Expand folders to browse your library. Turn off Folder tree in Settings for a flat list grouped by folder.
- Press Ctrl/Cmd+F to search file and folder names. Matching folders include their contents. Ctrl/Cmd+Shift+F hides the search and clears it.
- Click a file to select and preview it.
- Use Ctrl+Click (or Cmd on macOS) for multi-select, Shift+Click for range select.
- Ctrl/Cmd+A selects visible files in the first selected file’s folder, or all visible files if nothing is selected. Collapsed and filtered-out files are skipped.
- Drag files from the local panel to the device panel to upload.
- The waveform viewer shows an interactive waveform. Click the expand button on the waveform card to open the bigger waveform viewer.
- Detected pitch/key is shown as a badge (e.g. C4). The software sampler keyboard (keys Z-M) lets you preview local files at different pitches.
- Space toggles play/stop for the selected file.
Right Panel (Device Samples)
When a device is connected (or a backup is loaded), this panel shows all samples on the device with their slot number, name, duration, and file size.
- Use the range filter (001-999) to narrow down visible samples by slot range.
- Project badges (e.g. P1, P3) show which projects reference each sample. Project badges appear only for downloaded projects!
- Click a sample to preview it (triggers 1-second playback on the device).
- Double-click or use the context menu to rename samples (up to 16 characters).
- The waveform viewer shows the play mode, root note, and audio details. Use its toolbar to process a single sample.
Copy Samples
Upload (Local → Device): drag and drop files from the left panel or from your OS file manager onto the device panel. A confirmation dialog will show smart options:
- Mix down to mono - stereo files are mixed to mono to save device storage.
- Trim silence - removes leading silence using -50 dBFS detection.
- Normalize levels - peak-normalizes to 0 dBFS.
Download (Device → Local): right-click selected samples and choose “Download”. Files are saved as .wav with the pattern 001 Kick.wav.
Move/Cut & Paste: right-click > Cut to copy samples to an internal clipboard, then right-click on a target slot > Paste to move them.
Processing Local Samples

Use the waveform toolbar for one file, or select several files and right-click to process them together. Your original files stay untouched; edits are used for preview and upload. A green dot marks processed files.
- Remove leading silence - cut silence from the start of the sample.
- Normalize - raise the level so the loudest peak reaches 0 dBFS.
- Mix down to mono - combine stereo channels into one to save space.
- Reverse - play the audio backwards.
- Change sample rate - resample the audio. Lower rates save space without changing pitch or duration.
- Speed up ×2 - halve the duration and raise the pitch one octave.
- Slow down ×2 - double the duration and lower the pitch one octave.
- Trim - adjust the start and end points in the waveform before uploading.
- Process with CLAP plugins - apply an effect such as EQ, compression, or distortion to a sample.
- Clear processing (undo-arrow button) - reset all edits, including plugins, sample rate, and trim points. This resets the file, rather than undoing one step.
Sample Rate
Choose Change sample rate from the toolbar or right-click menu for local or device samples. Presets range from 11,025 to 46,875 Hz; the dialog shows the estimated size. Lower rates save space without changing pitch or duration, but lose some high frequencies. For local files, Original removes the rate conversion.
Processing with CLAP plugins
Editing Device Samples
Use the waveform toolbar for one sample, or select several and right-click to process them together. Audio edits are downloaded, processed, and uploaded back to the same slots on your device.
- Remove leading silence - cut silence from the start of the sample.
- Normalize - raise the level so the loudest peak reaches 0 dBFS.
- Mix down to mono - combine stereo channels into one to free up device storage.
- Reverse - play the audio backwards.
- Change sample rate - resample the audio. Lower rates use less device storage without changing pitch or duration.
- Trim - keep only the region between the waveform’s start and end points. Available for a single sample.
- Change root note - set the note that plays the sample at its original pitch.
- Change play mode - choose OneShot (play through), Key (follow the held note), or Legato (change pitch without restarting the sample).
For root note and play mode, choose a value and click Apply. These settings don’t affect samples already assigned to pads in projects.
Backups
Backups are complete archives of your device data stored as .pak (full device) or .ppak (single project) extension. They are essentially ZIP files.
- Backup all projects - creates a full device backup including all 9 projects and all samples.
- Backup single project - backs up one project and samples that are used in it.
- Load from backup - opens a backup file and loads all projects and samples for offline viewing, export, and sample browsing.
You can configure the default backup folder in Settings.
Settings
Open Settings in the sidebar. Changes are saved as you make them; there’s no Save button.
General

- UI Scale - make the interface smaller or larger, from 80% to 150% in steps of 10%.
- Show project card artwork - show or hide the illustrations in project card headers.
- Folder tree - show local samples in expandable folders. Turn it off for a flat list grouped by folder.
- Mix down to mono, Remove silence from start, and Normalize levels - preselect these options in the upload dialog. You can still change them before each upload.
- Check for updates on startup - check for a newer version when the app opens. You can also check manually on the About page.
- Confirm before delete samples - ask before deleting samples from the device.
- Automatically download all projects when a device is connected - load all nine projects into the app when you connect. This doesn’t create a backup.
Folders
Type a path or use the folder button to browse:
- Backup folder - where project and full-device backups are saved.
- CLAP plugin folders - add up to five folders containing your CLAP plugins. The app also checks the usual CLAP install locations.
The local sample folder is chosen on the Samples page, and the export folder on the Export page. They’re separate from the backup folder.
About
The About page provides:
- Software version - shows the installed version, build number, and update status. Click “Check for updates” to manually check. Enable auto-check in Settings to get notified on startup.
- Changelog - view what’s new in the current and previous versions.
- License - activate a license key received via email after purchase. The app works in demo mode without a license, with main features restricted.
- Feedback - report errors or send feedback directly to the developer. You can attach project files to help diagnose issues.
- EULA - view the software license agreement.
