A 16-track groovebox for the Akai MPC Sample
Melodee is a 16-track groovebox for the Akai MPC Sample. It runs on the MPC in place of the stock app, started from the microSD card. Each pad is a track: a drum kit, a keygroup (a sampled instrument), a plug-in instrument, a MIDI track for external gear, or an audio track. Tracks play patterns, patterns make sequences and a song, and every track has a mixer strip and an effect chain that takes plug-in effects.
Melodee does not change anything on the MPC itself. It runs from files on
the card. Choose MPC APP on its Exit screen, or remove its autorun
folder from the card, and the stock app runs as before.
Back up your card before you install Melodee.
New to Melodee? Start with the quickstart. For every page and control, read the user guide.
- 16 tracks, one per pad. Hold PAD BANK and press a pad to select a track from any page.
- VST3, LV2, CLAP and VST2 plug-in host: load instruments and effects from the card. Use a plug-in instrument as a track's sound, and plug-in effects on track, bus, master and loop chains. Melodee runs 64-bit ARM Linux builds, Open MPC plug-ins, and 32-bit ARM plug-ins through a bridge. It loads each plug-in's presets, keeps its state in the project, plays drum machine plug-ins on pads, and compensates for plug-in latency.
- Melodee synths: three Open MPC instruments of its own, Melodee Poly (analog-style polysynth), Melodee PD (phase distortion) and Melodee Chip (chip voice), each with factory presets.
- Kits of 128 pads in 8 banks, with the stock Sample mode pages (Trim, Mix, Amp Env, Tune, Play, Filter, Filt Env) plus Layers, Follow (tempo follow), Cloud (granular) and a kit filter. Each pad has its own effects and sends to the four buses.
- Sampling: Chop (by hits, regions, beats, or by hand as the sample plays, up to 64 slices), Sample Record, Audio Recall, Resample and 16 Levels. Samples load from WAV, MP3, FLAC, Ogg Vorbis and AIFF files. A sample longer than 10 seconds plays from the card, up to 6 hours; a project holds as many samples as fit in memory.
- Stems: separate a pad's sample into drums, bass, music and vocals on four new pads, on the MPC itself.
- Sampled instruments: SFZ, MPC keygroup and drum programs (
.xpm,.xty), MPC expansions (.xpn), Logic EXS24 (.exs), SoundFont (.sf2) and DecentSampler (.dspreset), streamed from the card, on a keygroup track or a kit pad. Stock MPC Sample projects (.xpj) open too. - Auto sampler: samples a plug-in track, or an external instrument on a MIDI track, into an MPC keygroup program on a new keygroup track.
- Audio tracks: record the input into a pattern, as on the MPC 3. Each take has its level, start and end, fades, reverse and warp.
- MIDI tracks for external synths and drum machines over USB-C or the MIDI jacks, with program changes, CC knobs and SysEx.
- Chords: MPC 3 chord progressions on the pads, on any track, and a chord builder for your own.
- Sequencing: 128 patterns per track in 8 banks, up to 128 bars each. Step sequencer, piano roll, step entry, parameter locks, ratchets and trig conditions. Sequences, as on the stock app, sequence chains and follow actions.
- Song: an arrangement with a lane per track, markers and a tempo lane. Export a WAV mixdown, stems, a MIDI file or an MPC 3 project.
- Looper: four loops that follow the tempo, with overdub and undo.
- Effects: 41 effects. A six-slot chain on every track, four send buses and the master. Knob FX, Pad FX, Flex Beat and the master compressor work as on the stock app.
- Freeze: print a track to audio and play it from the card, or deep freeze it to unload its plug-ins too.
- Sync: MIDI clock and MTC in and out, and CV clock out.
- The Menu: hold the encoder on any page for the page's jobs with their shortcuts, and the 16 places laid out as the pads. Four short lessons run on the MPC itself.
- Basic and Full: Basic shows the stock app's pages plus tracks, plug-ins, the mixer and Song. Full shows every page. Melodee starts on Full.
- Web page: connect the MPC to a computer by USB-C and open http://melodee.local to install updates and plug-ins, manage the card's files and read this guide. The MPC can also show up as a USB webcam with Melodee's screen.
- Updates from the card: copy a release zip to the card and Melodee installs it.
- Akai MPC Sample with firmware 1.3.0.12. On any other firmware Melodee does not start and the stock app keeps running.
- A microSD card.
- Download the latest
Melodee-MPC-Sample-<version>.zipfrom Releases. - Back up the card. If the card already has an
autorunfolder at its top level, move it somewhere safe. - Unzip it. The zip holds one folder,
autorun. Copy that folder to the top level of the card. Do not edit or rename anything inside it. - Put the card in the MPC and switch it on. The stock app starts first. A few seconds later Melodee starts.
The quickstart has the full steps, with screenshots.
Put plug-ins in Melodee/Plugins on the card (the Plugins folder inside
the Melodee folder at the top level), in any subfolders. Melodee loads:
- VST3 bundles with a
Contents/aarch64-linux/build - LV2 bundles (
.lv2folders) built for 64-bit ARM Linux (aarch64) - CLAP plug-ins (
.clapfiles) built for 64-bit ARM Linux (aarch64) - Open MPC plug-in folders
- VST2
.sofiles built for 64-bit ARM (aarch64) or 32-bit ARM (armv7)
Plug-ins built only for Windows or macOS do not run on the MPC. The plug-in picker shows them dimmed, with the reason.
The Melodee synths are free downloads:
Melodee Poly, Melodee PD and
Melodee Chip. From each release, download the
-mpc-sample.zip, unzip it and copy the plug-in folder inside (for example
Ellic Studio - VST - Melodee Poly) into Melodee/Plugins. The synths also run on
MPC OS devices that load Open MPC plug-ins; those devices use the
-mpc-aarch64.zip or -mpc-armv7.zip.
| Document | What it covers |
|---|---|
| Quickstart | Install, first start, a first beat, saving |
| User guide | Every page and control, and a chapter for users of the stock app |
| Reference | The complete control reference, file formats and internals |
The design notes for the Looper and MIDI tracks record the choices made while each was built. They are for developers; the user guide covers both.
Melodee is built for linux/arm64 in a Docker image. You need Docker and Python 3.
git clone --recurse-submodules https://github.com/keremimo/melodee-sample.git
cd melodee-sample
./build.sh./build.sh builds build/melodee, then runs the tests, a sound
self-test, a monkey test and the page previews (build/melodee-preview/).
| Path | Contents |
|---|---|
src/melodee/ |
The app: model, engines, pages, shell, design system |
src/main.cpp |
Connects Melodee to the sample-base runtime |
base/ |
sample-base (git submodule): drivers, runtime, build, install scripts |
tests/ |
Engine, sequencer and shell tests, layout and release checks |
tools/make_release.py, release/ |
The SD card release zip |
To run a build on an MPC over SSH, use device.py (the base's device tool):
python3 device.py startstart copies Melodee into RAM and starts it. status, ctl and
screenshot talk to the running app. install-sd starts it from the card at
every boot.
To make a release zip from a committed tree:
./release.sh v0.3.0This writes dist/Melodee-MPC-Sample-<version>.zip.
To move the base to its latest commit:
git -C base pull origin main
git add baseMelodee is free. If you use it, you can support it on Ko-fi.
Melodee is made by Kerem Kiliç (Ellic Studio).
Melodee is licensed under AGPL-3.0-only (LICENSE). It uses JUCE under the AGPLv3, and the Rubik typeface and the other screen fonts under the SIL Open Font License 1.1 (THIRD_PARTY.md). The boot animation's logo and backdrop are not covered by the AGPL.
Melodee is not affiliated with or endorsed by inMusic or Akai Professional. MPC and MPC Sample are trademarks of inMusic Brands.

