ProSign inJoin
Firmware

mvave-tankg-ble

Hype41/100

Control an M-Vave Tank-G multi-effects guitar pedal over Bluetooth LE

mvave-tankg-ble is custom firmware for the M-VAVE Tank-G, by @hudsonbrendon. Open source under MIT.

forM-VAVE Tank-G·by@hudsonbrendon

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

Downloads
0
Stars
0
Forks
0
Commit
1
Last commit
Get the source

No release files yet. Build from source.

MIT· hudsonbrendon/mvave-tankg-ble·downloads come from the creator’s GitHub releases

1
Commits
0
Releases
1 commit and 0 releases in the last year
Activity · last 12 months

M-Vave / Cuvave

mvave-tankg-ble

CI PyPI Python License: MIT

Control an M-Vave Tank-G multi-effects guitar pedal over Bluetooth LE.

The pedal speaks BLE-MIDI: presets are switched with a MIDI Program Change on channel 0, over the standard BLE-MIDI characteristic. This library is the pure Bluetooth layer — discovery, the command frames, and an async device class — with no Home Assistant dependency. It powers the Home Assistant integration.

Install

pip install mvave-tankg-ble

Usage

import asyncio
from mvave_tankg_ble import TankG, discover


async def main():
    devices = await discover(timeout=5.0)
    if not devices:
        print("No Tank-G found.")
        return
    async with TankG(devices[0]) as pedal:
        await pedal.set_preset(12)   # UI preset 1-36


asyncio.run(main())

TankG accepts a bleak BLEDevice (preferred — e.g. from Home Assistant's shared scanner or a Bluetooth proxy) or a string MAC/UUID address.

API

SymbolDescription
TankG(device)Async device wrapper. Use as an async context manager.
await pedal.set_preset(n)Switch to UI preset n (1–36).
await pedal.send_program_change(program, channel=0)Raw MIDI Program Change.
await discover(timeout=5.0)List nearby Tank-G pedals (list[BLEDevice]).
program_change_frame(program, channel=0)Build the raw BLE-MIDI frame.
preset_to_program(preset)UI preset (1–36) → MIDI program (0–35).
program_to_bank_position(program)Program → (bank, "A"/"B"/"C"/"D").

CLI

mvave-tankg scan              # list nearby pedals
mvave-tankg preset 12         # switch to preset 12 (scans first)
mvave-tankg preset 12 --address AA:BB:CC:DD:EE:FF

Scope & limitations

  • Presets only. The pedal exposes a proprietary Cuvave service (0xAE40) the official app uses for LED colour and other settings; that protocol is not reverse-engineered, so it isn't supported here.
  • No battery. The Tank-G doesn't report battery over BLE (the official app shows none) — only the physical "L"/"LO" display warning and the charge LED.
  • Presets are one-way. The pedal doesn't report its current preset, so there's no read-back.

License

MIT © Hudson Brendon