mvave-tankg-ble 0.1.0

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

mvave-tankg-ble

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

Symbol	Description
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