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 .exe installer is unsigned. So expect a warning from SmartScreen. Alternatively, you can install EP Toolkit directly from the Microsoft Store.
  • macOS: open the .dmg and drag EP Toolkit to your Applications folder.
  • Linux: download the .AppImage and make it executable with chmod +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-133EP-133 K.O. II (64mb and 128mb versions)
  • EP-1320EP-1320 Medieval
  • EP-40EP-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.
Make sure you have the latest firmware installed on your device. Older firmware versions may have bugs or compatibility issues. You can check for firmware updates on the Teenage Engineering website or through their official EP Sample Tool.
The app theme automatically adapts to the connected device: EP-133, EP-1320, or EP-40.

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 .ppak for single projects and .pak for 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:

Project card showing Project 2 with stats and action buttons

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 .ppak file.
  • 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.

Project 2 playing, with a stop button and scene progress strip

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.

Enable “Automatically download all projects when a device is connected” in Settings to skip the manual download step.

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.

Editor grid showing four scenes and their A, B, C, and D patterns

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.
Scene panel with group buttons, pattern previews, and scene actions

Saving and undoing

Editor toolbar with Reload, Undo, Discard, and Save to device

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 LiveAbleton Live 11+ - Simpler instruments with samples, envelopes, Drum Rack support, session clips or arrangement, grouped tracks, fader automation, scene names, and FX return tracks.
  • DAWprojectDAWproject (Bitwig, Cubase, etc.) - arrangement with clips and notes, scene/clip launcher, per-track volume/pan, samples in folder.
  • Standard MIDIStandard MIDI - SMF Type 1 with per-pad tracks, tempo, time signature, velocity, CC automation, samples in folder.
  • REAPERREAPER - arrangement with ReaSamplOmatic5000 sampler instruments, MIDI items, track grouping.
EP-40 Riddim projects can sound weird when exported to Ableton Live. Loop mode is not fully supported. We are working on it.

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.
Exported projects won’t sound identical to the device. The EP series uses a unique sound engine that no DAW can fully replicate. You’ll get a close starting point with all your samples, patterns, and mix settings - but expect to tweak things to taste.
Export settings panel showing options for project name, export folder, and format-specific settings

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.
    Arrangement view showing track list with scene and track options, and a preview of the exported Ableton Live set
Scene list showing options to include/exclude and rename scenes for export

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

ParameterAbleton LiveDAWprojectMIDIREAPER
LVLTrack VolumeTrack VolumeCC 7Track VOLPAN
PANTrack PanTrack PanCC 10Track VOLPAN
PTCSimpler TransposeTranspose--
TUNSimpler Fine TuneCC 76CC 76-
LPFSimpler Filter FreqCC 74 (Cutoff)CC 74-
HPFSimpler Filter FreqCC 71CC 71-
FXTrack Send LevelCC 91 (Reverb Send)CC 91-
ATKSimpler Attack TimeCC 73CC 73VST state
RELSimpler Release TimeCC 72CC 72VST state
MODSimpler Pitch LFOCC 1 (Mod Wheel)CC 1-
VELNote VelocityCC 107CC 107-
TIM-CC 105CC 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

Local sample waveform with processing controls and trim handles

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.

Another way to save space: speed up a local sample ×2 before uploading, then pitch it down 12 semitones on the device.

Processing with CLAP plugins

CLAP plugin processing dialog

Open the plugin dialog from the local waveform toolbar to apply a CLAP effect. Add your plugin folders in Settings → Folders.

Find plugins on CLAPDB or KVR Audio.

Apply one plugin at a time. To retry the same plugin with different settings, clear processing first.

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.

Backups created with EP Toolkit are fully compatible with EP Sample Tool.

Settings

Open Settings in the sidebar. Changes are saved as you make them; there’s no Save button.

General

General settings with UI scale, project artwork, folder tree, upload defaults, and connection options
  • 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.
The app works fully offline after license activation. Internet is only needed for activation, updates, and feedback submission.