Skip to content
sunskieferPublic

About

Orbit-based vector synth for Akai Force / MPC OS (VST2) — load SVG, 3D or image shapes to drive the sound.

Resources

Stars

4 stars

Watchers

0 watching

Forks

Repository files navigation

VADER

An orbit-based vector synthesizer for the Akai Force and MPC (MPC OS, VST2), by L'Cronx.

A note plays four sound sources at once, one in each corner of a square. A point, the orbiter, travels around a shape inside that square, and where it is decides how much of each corner you hear. Move the point and the sound morphs. The shape can be one of fifteen built-in figures, one of 35 maths shapes, a simulation (27 modes), or one you bring yourself: a drawing (SVG), a 3D wireframe (OBJ) or a picture (PNG/JPG), traced into a line. The screen draws that line, the orbiter with its trail of dots and the envelope, live, as glowing lines.

VADER's main page, the logo in the middle (tap it for the QR code)

The idea

I wanted a vector synth on the Force that works like the Beetlecrab Audio Vector: the same way of playing, and above all that screen, with the orbiter tracing its path while the sound moves between four corners. I wanted the knobs as on the hardware: envelope on the left, mixer and arpeggiator on the right, the screen in the middle with the overtone, filter, delay and chorus controls under it, and the second functions on an ALT layer. It is the same layout, with the parts moved around.

Then I wanted to go further than the hardware: load any image, vector drawing or 3D shape and let it drive the oscillators. The shape becomes the orbiter's path, and it can also be played as sound itself, the way vector graphics are drawn with audio on an oscilloscope.

The look: every knob is a line, a thin track with a thicker glowing blue line on top that grows with the value. No panel boxes, so my own background picture shows through. There is a strip across the top of every page, like on my BAZZLINE panels, showing the name and value of the last control touched. All the text is big, and so are the dropdowns.

VADER is its own engine, written for the Force's CPU. It is not a port and contains no Beetlecrab code, firmware or artwork; it is not affiliated with Beetlecrab Audio.

Inspired by and based on:

  • Beetlecrab Audio Vector: its orbiter and suborbit, its four corners of two overtone generators with a blend stage and filter each, its corner matrix, and firmware 3.0's two timbres.
  • Vector synthesis as Sequential's Prophet VS started it: mixing four sources from a point in a square.
  • Oscilloscope vector graphics: Vector Synthesis by Derek Holzer (Lissajous figures, 2D and 3D shapes drawn with audio). This is behind the SHAPE SOUND and the 3D shapes.
  • OSS Enterprise by Ocean Swift Synthesis: a hybrid vector synth with XY movement.
  • The MPC plugin framework mpc-vst-plugins, which makes native MPC OS plugins possible.

What's in it

  • Four corners, each two OVERTONE GENerators: 32 additive spectra (sine to saw, pulse widths, vowels, organ drawbars, bells, primes...), swept smoothly by one knob, band-limited so nothing aliases.
  • BLEND per corner: MIX, AM, PM, AM+PM, phase distortion, RING, FOLD.
  • A filter per corner: LP12, LP24, BP, HP or a ladder, placed after the blend or on either generator (the corner matrix), plus MASTER RESONANCE.
  • The orbiter: 15 built-in shapes (CIRCLE, FIGURE 8, STAR, SQUARE, TRIANGLE, two Lissajous, two roses, SPIRAL, HEART, ZIGZAG, SPIRO, and the 3D CUBE and ICOSA) or your own USER shape. It has speed, size, rotation, 3D spin and tilt, and a SUBORBIT circling the path point. It can sync to MPC's tempo, restart on each note, and grow or shrink with the envelope.
  • Your own shapes: SVG and OBJ from the plugin's Shapes folder (a PNG or JPG there is a picture for the IMAGE page, 0.10.2), or a VADER Shapes folder on your SD card or USB drive. Seven examples come with it.
  • SHAPE SOUND: the shape itself played as audio, x on the left, y on the right.
  • Two timbres: A and B, layered or split across the keyboard, each a complete sound. Unison up to 8 with detune, glide, vibrato, tremolo, 8 or 16 voices.
  • Arpeggiator with six directions, six rates synced to MPC, 1 to 4 octaves, latch, and a 16-step pattern (ON, ACCENT, TIE, OFF).
  • Effects: drive, chorus, ping-pong delay (synced, or free with TAP), reverb.
  • 22 presets in MPC's PRESET menu, from INIT ORBIT to the sample presets, and 999 slots for your own (MY PRESETS).
  • The IMAGE page: a picture plays the sound. Four MODs read the picture under the orbiter (BRIGHT, HUE, COLOUR, DEPTH as a landscape) or the outline (TURN, HEADING) and move CUTOFF, RESO, OCTAVE, PITCH, GEN 1, GEN 2, BLEND or LEVEL.
  • MODE: 27 simulations the orbiter can follow instead of a shape (BOIDS, LORENZ, GRAVITY WELLS, THUNDER, ...), each with its own eight live-named knobs and three layers.
  • 35 maths shapes: spirograph, harmonograph, Fourier drawing of any shape, mandala, times table, toy gears, Hilbert, Koch and more, each with four shape knobs.
  • VOICES: each corner can play VADER's own generators or one of 14 ZYNTH voices (analog, trio, wave, chip, macro, wheel, voice, noise, tone, metal, bazz, drone, texture, fx).
  • SAMPLES and WINDOW: a WAV per corner picked from a scrolling dropdown (54 examples included), one-shot, looped over 1 to 4 bars or OFF, rooted on C2, with START, END and LENGTH.
  • PLAY and TRAVEL: self play, drone chords, poly/dual/mono, randomize with undo, voice limit and CPU readout; speed LFO, stops at corners, path start/end, stretch, skew, morph, warp pad, sound balls, kaleidoscope, suborbit shapes (including MOBIUS).
  • Twelve pages: MAIN, CORNERS, ORBIT, IMAGE, ARP, FX, MODE, VOICES, PLAY, TRAVEL, SAMPLES, WINDOW. Q-Links are mapped on every page.

The screen: on your phone

MPC draws a plugin's screen itself, from pictures and the plugin's values; a plugin cannot draw on the Force's display directly, and every moving piece costs MPC a redraw (0.1 to 0.4 drew the screen from thousands of switchable pieces, and a busy one crackled the audio). Since 0.6.0 VADER's screen is the companion screen: a web page served by the plugin itself, on the Force's own network address, that any phone, tablet or laptop on the same Wi-Fi opens in its browser:

  • scan the QR code on the MAIN page with the phone's camera (or type the address shown on the ORBIT page; Apple devices can also use vader.local);
  • the page draws the shape as a glowing line (3D shapes shaded by depth), the orbit line, the orbiter with its light trail and the two balls in their size colours, smoothly, with a FULLSCREEN button. On a phone it always draws in landscape: hold the phone sideways. "Add to Home Screen" gives it an icon that opens it full screen like an app;
  • LOAD SHAPE on the page sends a picture (PNG, JPG), an SVG or an OBJ from the phone to the Force: it lands in the Shapes folder and plays at once;
  • several devices can watch at the same time. The Force sends 30 small messages a second and draws nothing: the sound gets the whole machine.

On the Force, the MAIN page shows the VADER logo where the screen was (tap it to swap it for the QR code, tap again for the logo), with bigger controls around it; the envelope line stays, drawn by MPC from 32 strokes that follow ATTACK, DECAY, SUSTAIN and RELEASE.

a loaded picture on the screen the CORNERS page
the ORBIT page the IMAGE page
the MODE page the VOICES page
the SAMPLES page the TRAVEL page

Install

Each release has three zips for MPC OS. Use the one that fits your machine:

MPC OS 3.10.1 or later, any MPC or Force, no mod needed (VADER-<version>-mpc-sdk.zip, since 0.10.0):

  1. On the MPC: Preferences, Enhancements (Beta): turn on Enable Enhancements and External Plugin Support.
  2. Unzip, and copy the L'Cronx - VST - VADER folder into a folder named exactly VST2 Plugins at the top of a USB stick, an SD card or the internal drive. It holds the 32-bit build (MPC X, Live, Live II, One, Key 61/37, Force) and the 64-bit build (MPC Live III, XL, One G2, Key G2).
  3. Load it on a track: it is under External Plugins.
  4. Your own shapes go in the folder's Shapes, samples in its Samples.

With the Open MPC Plugin Manager, or by SSH on a modded MPC or Force (VADER-<version>-mpc-armv7.zip for the 32-bit MPCs and the Force, VADER-<version>-mpc-aarch64.zip for the 64-bit MPCs):

  1. Download it from Releases (the Plugin Manager does this itself).
  2. Unzip it and follow INSTALL.md inside; the installer stops MPC, adds VADER to the plugin list and starts MPC again.
  3. Load it on a track: Plugin → VST → VADER.
  4. Put your own shapes in L'Cronx - VST - VADER/Shapes/ inside the Synths folder you installed to.

With either, a folder called VADER Shapes (or VADER Samples) at the top of your SD card or USB drive is read too.

MPC OS 3.x. The skin uses the MPC OS 3 format.

Desktop: VST3 + VST2 for Windows and Linux

VADER also builds as a desktop plugin with the orbit screen drawn in its own window. Install steps, folders and limits are in docs/DESKTOP.md; build it with desktop/build.sh linux|windows.

The desktop zips include the example samples (inside VADER.vst3, and a Samples folder beside the VST2 file); the plugin finds them by itself.

Presets you save on the desktop (MY PRESETS, the USER ###.vader files) also load on the Force; see the user guide.

PLUG (0.9): press PLUG in the desktop window and it becomes the Force's VADER on your PC: the Force's screen drawn large and sharp, every control showing the Force's value, and every control you move going to the Force at once. Found on the network by itself, or by a typed address. See docs/DESKTOP.md.

Use

Read the user guide. It covers every page, every control and every Q-Link, with recipes and tips on making shapes.

The quick version: play a chord, then turn ORBIT SPEED and ORBIT SIZE and watch the orbiter. Pick a SHAPE. Set CORNER SELECT to one corner and turn OVERTONE GEN 1 and 2, BLEND and the filter to change what that corner sounds like. Press ALT for the second function of each knob.

Build

pip install ziglang pillow numpy
./build.sh                 # -> build/package/L'Cronx - VST - VADER/
test/run_tests.sh          # the engine and the VST2 wrapper, under valgrind (NOVG=1 to skip it)
test/arm_sim.sh            # the engine test as ARM code under qemu (needs qemu-user)

The parameters live in one place, tools/gen_params.py. The pages are in tools/vader_skin.py, and tools/preview.py draws them with the engine really playing (the pictures above). The engine is in src/.

Status

0.10.7 has not been tried on a device yet. 0.10.7 makes a picture (PNG/JPG) feed the IMAGE page only (the shape stays), fixes BRIGHT (it read green as black), smooths the picture map and lifts the 4 MB file limit to 96 MB / 24 megapixels, checked offline with the plugin's own loader on 12 pictures; 0.10.6 adds a Shapes folder to the desktop zip (inside the VST3 and beside the VST2); 0.10.5 fixes the desktop plugin, where the per-corner envelope did not follow CORNER SELECT; 0.10.4 makes the envelope per corner (CORNER SELECT A–D: that corner's ADSR; ALL: every corner together); 0.10.3 gives each corner a sample dropdown with a scrollbar and makes the desktop window pure black; 0.10.2 made each corner's sample MODE the switch (OFF: the voice only; a sample mode: the sample only). 0.10.0 added the 64-bit build for the newer MPCs and the zip in Akai's plugin format (MPC OS 3.10.1); the sound and the pages are 0.9.2's. 0.9.1 was tried on the Force and on a real Windows PC. Offline (2026-11-13) it passes the engine test (every preset, shape, mode, voice, blend mode and filter) as x86, 32-bit ARM and 64-bit ARM code, the VST2 host test, the modes and shapes test, the companion screen's server test and the PLUG test (also served by the 64-bit ARM build, under qemu) and the desktop host test; the folder in the -mpc-sdk.zip passes the checker of Akai's MPC Plugin SDK (one warning: version.xml has no <uiversion>) and the armv7 and aarch64 zips pass the catalog check. See CHANGELOG.md for what each version added.

License

The code written by L'Cronx for VADER (the Force plugin and the desktop plugins) is licensed under the PolyForm Noncommercial License 1.0.0 (see LICENSE). The source is public and free to use, change and share for any noncommercial purpose. The point is to stop others selling VADER or using it commercially; it is and stays free.

Credits: other people's code stays theirs

That license covers only L'Cronx's own code. The code below was written by other people, belongs to them, and stays under the licence its authors chose; VADER claims no ownership of it and the PolyForm license does not replace theirs. Their copyright notices and licence files are kept in the repo.

  • LXR-02 Open-Source (third_party/lxr02open), copyright 2026 Brendan Clarke, a port of the Sonic Potions LXR software: his own licence applies (not to be sold or used in a commercial product or activity; modified redistributions must include the complete source). Thank you, Brendan.
  • Braids, Plaits and stmlib (third_party/mutable) by Emilie Gillet (Mutable Instruments): MIT.
  • FM6 algorithm table from music-synthesizer-for-android (fm_core.cc, copyright 2012 Google Inc.): Apache License 2.0.
  • mpc-vst-plugins (third_party/mpc-vst-plugins), the Force plugin framework: MIT.
  • stb_image (third_party/stb): public domain / MIT.
  • Chakra Petch font (art/fonts): SIL Open Font License 1.1.
  • DPF (third_party/DPF) and what it carries, for the desktop plugins: ISC and others; see desktop/THIRD_PARTY.md.

About

Orbit-based vector synth for Akai Force / MPC OS (VST2) — load SVG, 3D or image shapes to drive the sound.

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages