AcidBox [Mynah]

AcidBoxMynah is an alternative firmware that turns the Mynah into an acid groovebox.

Based on the open source AcidBox project. It provides:

[an] acid combo of tb303 + tb303 + tr808 like synths. Filter cutoff, reso, env mod, accent, wavefolder, overdrive within each 303, per-instrument tunings, hi-pass/lo-pass filter and bitcrusher in drums, send to reverb, delay and master compression

While the original project is headless, the AcidBoxMynah fork provides direct control with the Mynah hardware and adds a number of additional features detailed in the user Manual below. Like the original firmware, the AcidBoxMynah is open source and made available under the MIT license.

To switch to AcidBoxMynah, flash the firmware in the firmware tab of the Mynah webapp. Follow the How to Use instructions on that page.

NOTE: The following webapp tabs are not supported with the AcidBoxMynah firmware: Stem Export, Bounce, Songs, Screen Mirror, and SD Cleanup.

AcidBoxMynah files and samples live in their own AcidBox folder on the SD card and won’t overwrite or conflict with standard Mynah files. It’s safe to switch between the standard Mynah firmware and AcidBoxMynah firmware at will.

Mynah kits shipped after the release of AcidBoxMynah already have sample files for additional drum kits in place on the bundled SD card. For earlier kits, download and place the following folder on the Mynah’s SD card: KITS.zip

Unzip the folder and ensure the SD directory structure looks like this:

AcidBoxMynah User Manual

User Manual V1.0

Overview

Firmware Features

The original AcidBox is a great-sounding TB-303 emulation with two synth parts and a drum part. AcidBoxMynah puts that engine to work on the Mynah hardware, providing it with a full physical UI.

Key Hardware Features

  • 24 tactile switches (16 step buttons + 8 function keys).
  • Single potentiometer for parameter control.
  • OLED display.
  • 8×2 NeoPixel grid for sequencing and visualization.

Sequencing & Automation

  • 16-step sequencer with per-step note, accent, and slide editing.
  • 16-lane synth automation and 8-lane drum automation.
  • Scale quantization, swing, and BPM control.
  • Dual modes: autonomous Jukebox Mode or manual Sequencer Mode.

System & UI Improvements

  • Runtime drum kit browsing and pattern/song/drum kit SD card organization.
  • Per-voice mute toggling and quick volume shortcuts (F-key + pot).
  • Pot-lock protection to prevent unexpected parameter jumps during mode changes.
  • Decoupled UI polling (Core 0 @ 200Hz) from the real-time audio pipeline (Core 1).

Control Reference

Transport

ButtonFunction
F8Start / Stop (Toggle)

Operating Mode

Button ComboFunction
F1 + F8Sequencer Mode / Jukebox Mode (Toggle)

Part Select

ButtonPart
F2SYNTH 1
F3SYNTH 2
F4DRUMS

Part Mute

ButtonFunction
F2 (double-press)SYNTH 1 (Toggle Mute)
F3 (double-press)SYNTH 2 (Toggle Mute)
F4 (double-press)DRUMS (Toggle Mute)

Drum Voice Selection

Kit folders are numbered on the SD. Legacy kits (from the original AcidBox project) are loaded in the order that files appear on the SD – the new format explicitly looks for a filename prefix to map files to instruments. The total size for a kit is about 1.5MB. The following file format is recommended: .WAV, 44,100 Hz mono, 16-bit PCM.

Button ComboDrum VoiceMIDI Note
(Chan. 10)
SD File Prefix
F4 + A1BD (Bass Drum)1601_
F4 + A2SD (Snare Drum)1702_
F4 + A3CH (Closed Hi-Hat)2203_
F4 + A4OH (Open Hi-Hat)2304_
F4 + A5CLAP (Hand Clap)2005_
F4 + A6LT (Low Tom)1806_
F4 + A7MT (Mid Tom)1907_
F4 + A8HT (High Tom)2108_
F4 + B1CR (Crash Cymbal)2509_
F4 + B2RIM (Rimshot)2410_
F4 + B3MAR (Shaker/Maraca)2711_
F4 + B4CLAV (Claves)2612_
F4 + B5COW (Cowbell)2813_
F4 + B6CY (Cymbal)2914_
F4 + B7CONG (Conga)3015_
F4 + B8TIMB (Timbale)3116_

Drum Kit Selection

Button ComboFunction
F1 + F4Drum Kit Selection
F1 + F2Previous Kit
F1 + F3Next Kit
F4Load Kit

Parameter Selection (SYNTH 1 & SYNTH 2)

  • First Select SYNTH 1 or SYNTH 2 (F2 / F3)
Button ComboParameter
F1 + A1CUTOFF (Filter Cutoff)
F1 + A2RESO (Filter Resonance)
F1 + A3WAVE (Waveform Shape)
F1 + A4ENV MOD (Envelope Modulation Level)
F1 + A5PAN
F1 + A6DELAY (Delay Send)
F1 + A7REVERB (Reveb Send)
F1 + A8VOLUME (Part Volume)
F1 + B1SLIDE (Mark steps as slides with A1-8, B1-8. Set the slide speed with the potentiometer.)
F1 + B2ACCENT (Mark accented steps with A1-8, B1-8. Set the accent level with the potentiometer.)
F1 + B3ATTACK (Envelope Attack)
F1 + B4DECAY (Envelope Decay)
F1 + B5DISTORTION
F1 + B6OVERDRIVE
F1 + B7SATURATOR
F1 + B8TUNING

Parameter Selection (DRUMS)

  • First Select Drums (F4)
Button ComboParameter
F1 + A1CUTOFF (Filter Cutoff)
F1 + A2RESO (Filter Resonance)
F1 + A3SN TONE (Snare Tone)
F1 + A4BD DECAY (Bass Drum Decay)
F1 + A5BD TONE (Bass Drum Tone)
F1 + A6DELAY (Delay Send)
F1 + A7REVERB (Reveb Send)
F1 + A8VOLUME (Part Volume)

Sequencer Controls

Button ComboParameter
A1 – A8, B1 – B2Toggle steps on/off
A1 – A8, B1 – B2 + POTAdjust pitch per step
F1 + POTRecord automation for current parameter
F5PART CREATE (Create a note pattern on the current part. Confirm with F5.)
F8 + F5PART CLEAR (Clear the current part. Confirm with F5.)
F6PATTERN CREATE (Confirm with F6)
F8 + F6PART CLEAR (Clear the current pattern. Confirm with F6.)

Global Parameter Selection

Button ComboParameter
F8 + A7SWING
F8 + A8BPM (Tempo)
F8 + B1SCALE
F8 + B2ROOT (Root Note)
F8 + B8GLOBAL VOLUME

Load/Save

Button ComboFuntionality
F8 + A1Select PATTERN PAGE
A1 – A8, B1 – B2Hold to save a pattern. Press to load.
F8 + A2Select SONG PAGE
A1 – A8, B1 – B2Press to select a song.
F8 + A3Select BANK PAGE
A1 – A8, B1 – B2Press to select a bank.

MIDI Channel Summary

ChannelFunctionNote inputNote outputCC / other input
1Synth 1Monophonic synth notesSynth 1 sequencer/jukebox notesSynth 1 CCs, pitch bend, global reset commands
2Synth 2Monophonic synth notesSynth 2 sequencer/jukebox notesSynth 2 CCs, pitch bend
3SweepNotes 1–16 trigger presets A1–B8NoneNo Sweep CC mapping
10DrumsSample/instrument notesDrum sequencer/jukebox notesDrum CCs, program change
16Pattern syncBank/song/pattern selection protocol when configured as followerBank/song/pattern messages when configured as leader; follower echoes received messagesNot a musical voice channel

Global CCs

CCNameBehavior
84Delay timeSets the global delay length from 0.0 to 1.0 normalized
85Delay feedbackSets global delay feedback
86Delay levelSets global delay level
87Reverb timeSets global reverb time; available when PSRAM/reverb is enabled
88Reverb levelSets global reverb level; available when PSRAM/reverb is enabled
93Compressor ratioMaps to approximately 3.0 through 42.0
120All sound offUses the reset-command path described below
121Reset all controllersUses the reset-command path described below
123All notes offUses the reset-command path described below

Synth 1 & Synth 2 CCs (Chan. 1 & 2)

CCParameterBehavior
5Portamento timeSets slide time in milliseconds using the raw CC value
7VolumeSynth voice volume
10PanStereo pan
65PortamentoEnabled when value is >= 64
70WaveformBlends the available waveform tables
71ResonanceFilter resonance
72DecayMaps to filter and amp decay times
73AttackMaps to filter and amp attack times
74CutoffFilter cutoff
75Env mod levelFilter-envelope modulation amount
76Accent levelAccent amount
91Reverb sendSynth reverb send
92Delay sendSynth delay send
94DistortionDistortion amount
95OverdriveOverdrive amount
104TuningSelects a tuning value from the firmware tuning table

Drum CCs (Chan. 10)

CCParameterBehavior
7VolumeOverall sampler volume
8Note panPan for the currently selected sample/note
21Bass drum toneSelects BD and changes its pitch/tone
23Bass drum decaySelects BD and changes its decay
24Bass drum levelSelects BD and changes its level
25Snare drum toneSelects SD and changes its pitch/tone
26Snare snapSelects SD and changes its decay/snap
29Snare drum levelSelects SD and changes its level
61Closed-hat tuneSelects CH and changes its pitch
63Closed-hat levelSelects CH and changes its level
72Note decayChanges the currently selected sample decay
73Note attack/offsetChanges the currently selected sample start offset
74Filter cutoffSampler filter cutoff
71Filter resonanceSampler filter resonance
80Open-hat tuneSelects OH and changes its pitch
81Open-hat decaySelects OH and changes its decay
82Open-hat levelSelects OH and changes its level
89PitchCurrently selected sample pitch
90Note selectSelects the sample/instrument to edit
91Reverb sendSampler reverb send
92Delay sendSampler delay send
94DistortionSampler bit-crusher amount; zero resets it to clean

Sweep triggers

MIDI notePreset bank/buttonInternal preset index
1A10
2A21
3A32
4A43
5A54
6A65
7A76
8A87
9B18
10B29
11B310
12B411
13B512
14B613
15B714
16B815

Pattern Sync (Chan. 16)

Note rangeMeaningValue calculation
1–16Bank 1–16bank = note – 1
21–36Song 1–16song = note – 21
41–56Pattern 1–16pattern = note – 41