Skip to content

About

Melodee groovebox for the Akai MPC Sample, on sample-base

Resources

Stars

58 stars

Watchers

2 watching

Forks

Repository files navigation

Melodee

A 16-track groovebox for the Akai MPC Sample

Melodee screens on the 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.

Features

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

Requirements

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

Install

  1. Download the latest Melodee-MPC-Sample-<version>.zip from Releases.
  2. Back up the card. If the card already has an autorun folder at its top level, move it somewhere safe.
  3. 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.
  4. 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.

Plug-ins

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 (.lv2 folders) built for 64-bit ARM Linux (aarch64)
  • CLAP plug-ins (.clap files) built for 64-bit ARM Linux (aarch64)
  • Open MPC plug-in folders
  • VST2 .so files 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.

Documentation

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.

Build from source

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 start

start 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.0

This writes dist/Melodee-MPC-Sample-<version>.zip.

To move the base to its latest commit:

git -C base pull origin main
git add base

Support

Melodee is free. If you use it, you can support it on Ko-fi.

Credits and licence

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.

About

Melodee groovebox for the Akai MPC Sample, on sample-base

Resources

Stars

58 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages