NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #3969 most downloaded on pub.dev
A common platform interface for the FlutterMidiCommand plugin.
Last release 24 days ago
14 Sep 2026
Ships unpredictably
gaps range from 8 days to 1.7 years
Nearly every release is documented
notes for 25 of 25 stable releases
1 version withdrawn
withdrawn after publishing
6 years old
27 releases · first in 2020
FIX: resolve MIDI running status correctly on every transport. A device that sends a status byte once and then only data bytes — an M-VAVE SMK-25 Mini
MidiMessageSplitter in flutter_midi_command_platform_interface is the shared MIDI-assembly stage every transport now feeds, and MidiPacket documents the contract they all satisfy: data is exactly one complete MIDI message with all transport framing removed.MidiMessageParser aborts an open SysEx on a status byte rather than burying it in the payload, and bounds its buffer.^1.3.0.One column per quarter.
MidiMessageSplitter, the shared MIDI-assembly stage every transport feeds once it has stripped its own framing. It resolves running status, keeps partial messages across calls, reassembles and bounds SysEx, and emits System Real-Time bytes without disturbing the message around them. Its eight numbered rules are the one specification the Dart, Kotlin and Swift implementations answer to.MidiPacket documents the contract every transport is now made to satisfy — data is exactly one complete MIDI message with all transport framing removed, and the buffer belongs to the listener.FIX: addVirtualDevice, removeVirtualDevice and setNetworkSessionEnabled return Future instead of void. The platform call was previously discarded, so
addVirtualDevice, removeVirtualDevice and setNetworkSessionEnabled return Future<void> instead of void. The platform call was previously discarded, so a failure such as PlatformException(AUDIOERROR, Error -2 while create MIDI virtual source) escaped as an unhandled asynchronous error that no try/catch around the call could see. Await them to handle failures. Existing calls that ignore the result keep compiling; custom MidiCommandPlatform implementations must widen these three overrides from void.setNetworkSessionEnabled(true) rather than at plugin init, so apps using only Bluetooth, USB or virtual MIDI never trigger it. Thanks to @aleksei-svezhevskii for the fix.^1.2.0.addVirtualDevice, removeVirtualDevice and setNetworkSessionEnabled return Future<void> instead of void on both MidiCommandPlatform and MethodChannelMidiCommand, which no longer discards the host API call. Platform implementations must widen these three overrides from void.FIX(ble): retry a connection sequence whose link was torn down mid-handshake. universal_ble reports that as deviceDisconnected rather than a GATT stat
deviceDisconnected rather than a GATT status, so the retry shipped in 1.1.1 did not apply. Unlike a GATT status the code cannot arise from a peripheral that was never reachable, so it is honoured on every platform.^1.1.2.1.1.2 for the synchronized workspace release.FIX(ble): retry the whole connection sequence through transient Android GATT_ERROR 133 failures, including failures during service discovery and notif
GATT_ERROR 133 failures, including failures during service discovery and notification subscription.stopScan failures when Bluetooth is switched off during a scan instead of surfacing an unhandled asynchronous error.^1.1.1.1.1.1 for the synchronized workspace release.FIX(darwin): read every packet of a coalesced MIDIPacketList from the original list memory. Packets after the first were read from unrelated memory an
MIDIPacketList from the original list memory. Packets after the first were read from unrelated memory and anything over 256 bytes was truncated, affecting virtual devices; native devices already had a correct implementation. Virtual device timestamps now report nanoseconds, matching native devices.MidiCommand.sendDataAwaitingDelivery, completing once the transport has written the data rather than queued it, so a bulk transfer can pace against the link rather than a fixed delay. Only the BLE transport observes delivery; platform-routed devices complete immediately, as with sendData.UniversalBleMidiTransport flags useNegotiatedMtu and requestHighPerformanceConnection opt out. These apply on Android, Windows and Linux; on iOS and macOS a connected device is handed over to CoreMIDI, which then owns the write path.MidiCommand.onBleWriteFailure, reporting BLE writes the platform rejected. sendData is fire-and-forget, so this is the only signal that a packet was dropped. Bulk transfers that split a payload across many SysEx messages should treat any event as a corrupted transfer. Silent on Apple platforms for devices handed off to CoreMIDI, which has no equivalent per-write signal, so it complements rather than replaces device-level acknowledgements.0xF7 in every SysEx packet. It was omitted whenever the remaining body was exactly one byte short of the packet size.MidiBleTransport gained onWriteFailure. Classes using implements MidiBleTransport must declare it; extends and all API consumers are unaffected. See the platform interface changelog.^1.1.0.MidiWriteFailure and MidiBleTransport.onWriteFailure, so a BLE transport can report writes it accepted from the fire-and-forget sendData but could not deliver. The getter has a default empty-stream implementation for transports that cannot detect write failures.MidiBleTransport.sendDataAwaitingDelivery, which completes once the data has been written rather than queued, so a bulk transfer can pace against the link. Defaults to sendData for transports that cannot observe delivery.implements MidiBleTransport must now declare onWriteFailure and sendDataAwaitingDelivery, because Dart requires implements to provide every member regardless of a default body. Classes using extends are unaffected, as are all consumers of the API.FIX(ble): stop the opportunistic MTU request from stalling Android connections. It was issued from the connection callback and, because universal_ble
GATT_ERROR 133 (surfaced as Unknown Error 133).GATT_ERROR 133, and keep the device in the transport cache across that retry so received data still resolves to it.^1.0.9.1.0.9.FIX(darwin): report CoreMIDI destinations as inputPorts and sources as outputPorts so port direction matches Android and the public device-owned API c
inputPorts and sources as outputPorts so port direction matches Android and the public device-owned API contract (#164).^1.0.8.MidiDevice.inputPorts and outputPorts are described from the MIDI device's perspective.FIX: export MidiPairingInfoRemovedException from package:flutter_midi_command/flutter_midi_command.dart.
MidiPairingInfoRemovedException from package:flutter_midi_command/flutter_midi_command.dart.^1.0.7.1.0.7 for the synchronized workspace release.FIX: a disconnect that races an in-flight connect no longer surfaces as an unhandled async error on PlatformDispatcher.onError (#160).
PlatformDispatcher.onError (#160).MidiPairingInfoRemovedException when a peripheral has removed its pairing information (iOS CBErrorPeerRemovedPairingInformation), best-effort clearing the stale bond, instead of leaking a raw UniversalBleException.ConnectedDevice teardown now survives the IOException: EPIPE from a removed device (#158).devices refresh no longer collapses an in-progress connect to disconnected (#159).MidiPairingInfoRemovedException for BLE peripherals that have removed their pairing information.FIX(ios): keep usable non-bonding BLE MIDI connections alive when no CoreMIDI counterpart appears, and perform bonded-device handoff as an optional at
1.0.5.FIX(ci): track pubspec_overrides.yaml so melos bootstrap works on clean checkouts.
FIX(ble): hide registered devices until rediscovered.
FIX: update example app to iOS v14 minimum.
fix(darwin) fix corebluetooth to coremidi handover
Resolved the Windows example build failure caused by deprecated coroutine headers in older universal_ble releases.
3.44.2 so the newer BLE dependency resolves in GitHub Actions.universal_ble releases.flutter_midi_command_ble) and optional BLE wiring via configureBleTransport.MidiDeviceType, MidiHostDevice, MidiPort, MidiPacket) across platform bridges.flutter_midi_command_web) using browser Web MIDI.connectToDevice completes on connection).MidiMessageParser and MidiMessage.parse) with support for running status, realtime interleaving, SysEx, and NRPN/RPN message flows.Refresh Devices and Scan BLE controls.added android:exported="true" to manifest
added android:exported="true" to manifest
Fixed BLE congestion issues on iOS
Fixed BLE congestion issues on iOS
Fixed issues with timestamp and network sessions in Swift
Fixed issues with timestamp and network sessions in Swift
isNetworkSessionEnabled and setNetworkSessionEnabled for controlling Network Sessions on iOS (introduced in FlutterMidiCommand 0.4.15)Fixed missing future from native
Fixed missing future from native
Updated to new connectDevice function which return a future Aligned status updates from native across platforms
Updated to new connectDevice function which return a future Aligned status updates from native across platforms
Changed permissions to fine location for BLE on Android, required when targeting sdk 29+
Changed permissions to fine location for BLE on Android, required when targeting sdk 29+
Fixed nullable error in kotlin
Fixed nullable error in kotlin
Fixed BLE timestamp on iOS
Fixed BLE timestamp on iOS
Fixed device disconnect on iOS
Fixed device disconnect on iOS
Added linux support
Added macOS implementation. Cleaned iOS code (shared with macOS).
Added macOS implementation. Cleaned iOS code (shared with macOS).
Migrated to federated plugin using platform interface.
Migrated to federated plugin using platform interface.
Your coding agent can read these notes before it upgrades. Set up the MCP server →