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

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