ProSign inJoin
Firmware

mvave-chocolate-tui

Rising52/100

Terminal UI for configuring the M-Vave Chocolate MIDI footswitch controller on Linux

mvave-chocolate-tui is custom firmware for the M-VAVE Chocolate, by @WilsonNet. Open source under GPL-3.0, 4 stars on GitHub.

forM-VAVE Chocolate·by@WilsonNet

Unclaimed. Is this yours? Sign in with GitHub as @WilsonNet to claim it.

Downloads
0
Stars
4
Fork
1
Commits
10
Last commit
Get the source

No release files yet. Build from source.

GPL-3.0· WilsonNet/mvave-chocolate-tui·downloads come from the creator’s GitHub releases

9
Commits
0
Releases
9 commits and 0 releases in the last year
Activity · last 12 months

M-Vave Chocolate TUI

A terminal UI for configuring the M-Vave Chocolate Bluetooth MIDI footswitch controller on Linux.

No more Windows VM or Wine just to change footswitch assignments. Edit CC numbers, switch modes, and send SysEx config directly from your terminal.

Features

  • Auto-detection — finds your Chocolate (SINCO/FootCtrl) via /proc/asound/cards, no hardcoded paths
  • 16-switch grid — 4 banks × 4 switches, all visible and editable
  • Real-time MIDI monitor — see footswitch presses as they happen
  • SysEx configuration — sends proper Jieli-manufacturer SysEx to reprogram the device
  • Mode switching — toggle between Custom CC, Program Change, Keyboard, and more
  • Non-blocking I/O — writes use amidi subprocess; reads run in background goroutine
  • Connection recovery — clean open/close, handles unplug/replug

Requirements

  • Go 1.26+ (managed via asdf)
  • alsa-utils (amidi command)
  • M-Vave Chocolate in U (USB) mode (not HOST)

Quick start

go run .

The TUI auto-detects your Chocolate and shows the switch grid.

Usage

KeyAction
eEdit highlighted switch
sSend all config to device
rRead current config from device
mChange operating mode
tab / lToggle MIDI log view
↑↓←→ / h/j/k/lNavigate switch grid
qQuit

Editing a switch

  1. Press e on the switch row you want to edit
  2. Tab between fields: Type (cc/pc/note), CC/Note, Channel, On Value, Off Value, Latching
  3. Press Enter to save the edit
  4. Press s to send all changes to the device

Connecting to your Ampero / multi-effects

  1. Set the Chocolate to Custom CC mode (press m, select "Custom CC", press Enter)
  2. Edit each switch to match the CC numbers your Ampero expects
  3. Press s to send
  4. Connect the Chocolate MIDI OUT to your Ampero MIDI IN

How it works

The M-Vave Chocolate is a Jieli-based USB MIDI device (vendor 00 32). It accepts SysEx configuration messages to reprogram what each footswitch sends. The cbix project at cbix/mvave-chocolate-sysex documented the protocol.

  • Reads: raw ALSA MIDI device (/dev/snd/midiC*) opened O_RDONLY in a goroutine
  • Writes: amidi -p hw:X,0,0 -S <hex> subprocess — uses ALSA library, never blocks the UI
  • Checksum: 0x28A - sum(all bytes) - subcommand - value (verified against 18 known-good examples from the cbix repo)

Testing

# All tests (unit + E2E with real device)
go test -v ./...

# Unit tests only (no device needed)
go test -v -run "TestKnown|TestBuild|TestChecksum|TestCC" ./...

# Headless E2E (requires Chocolate in U mode)
go test -v -run TestHeadless ./...

# Lint
golangci-lint run ./...

Troubleshooting

"device or resource busy" — a previous instance didn't close cleanly. Run:

fuser -k /dev/snd/midiC*

TUI can't find the device — make sure the Chocolate side switch is on U (USB), not HOST. Check with:

amidi -l

Should show SINCO MIDI 1.

Config not persisting — the Chocolate may store config in volatile memory. The SysEx is accepted (device responds OK) but some settings revert on power loss. The TUI reads current config on startup (r key).

License

GPL-3.0-or-later. See LICENSE.