Please, read this before upgrading:

Backup your own project.
If you get errors after updating, please quit Unity Editor and reload your project (GUID must be updated).
If you are upgrading from an older version and the error persists, please, read here.

Thank for your comments and talks, that help a lot to make Maestro better.

Look here for full release notes Maestro news.

V2.17.0 2025-12-07

Improved spatialization with two new parameters: MPTK_MinDistance for distance at which attenuation begins. MPTK_MinSoundAttenuation for minimum volume applied at maximum distance.
The free Maestro edition is now based on the GS v2.0.2 SoundFont from Christian Collins — many thanks to him! Enjoy noticeably enhanced audio.
Ability to pause and resume voices with smooth transitions (especially useful for MidiStreamPlayer) (Pro).

V2.16.2 2025-10-31

New Feature

MPTK_PauseOnMaxDistance: MIDI player automatically paused when the distance from the listener exceeds MPTK_MaxDistance. Default is true (pause).
Official version compatible WebGL.
MPTK_Core set to false when Unity WebGL selected (legacy mode).
Added MPTK_ListPresetDrum, MPTK_PresetsNameDrum, MPTK_PresetsNumberDrum.

Demo & MVP

Helper to migrate MPTK demos to Unity 6.
Remove some design not compliant to Unity 6.
MidiChannel MVP: now displays channel information.
MidiFileWriter: now working with WebGL (removes local file management).
TestEuclideanRhythme: now working with WebGL (uses coroutine).
TestMidiExternalPlayer: now working with WebGL (uses coroutine).
TinyMidiSequencer: deprecated (source code still available).

Fix

Parameter AlreadyLoaded was not used when MIDI Player is in autorestart mode.
WebGL: all voices are now cleared when stopping a MIDI.
WebGL: playback now starts at the first note.
WebGL: MidiExternalPlayer for WebGL compatibility (move MIDI to as CORS compliant server).
WebGL: MPTKWriter is now compliant (direct play only).
MPTK_CurrentTempo: get rounded to the nearest integer. Thanks to cihadturhan_unity.
Correct issue on quantization calculation. Thanks to cihadturhan_unity.

V2.15.0 2025-04-25

New Features

SoundFonts can be dynamically loaded either from a local file system or directly from the web.
Supports assigning different SoundFonts to different MIDI players.
Delays line number for reverb now can be expanded to 12 (default is 8) to produces a better quality sound but with a cpu cost. Add script symbols MPTK_REVERB_NBR_DELAYS_12 to expand.
Changes the way each note-on velocity affects the attenuation of a voice. A higher value increases the volume at low velocity (the fluidsynth constant FLUID_PEAK_ATTENUATION is modified). Perfect for soundfont with not audible notes at low velocity. See member MPTK_VelocityAttenuation (experimental feature).
Easier access to the verbose modes in the inspector.
Access to MPTK custom ChatGPT from the About MPTK.

Demo & MVP

TestLoadingExternalSoundFont: use of the new MPTKSoundFont class (pro), predefined soundfonts, quick switching, ...
MidiChannel: Free MVP, three simple demos in one! disable all channels but not drum, apply sustain, play extra notes ...
HackYourMIDI: Pro MVP, how to transform a MIDI note-on on to an arppegio.

Fix

MPTK_LoadLiveSF is deprecated but is still working.
Correct abrupt reverb off when any voice is active.
Update from FS 2.3: ignore note-off for non looped samples in the attack phase and improve amp calculation.
Improve MIDI sort and set priority for bank change (dramatically decrease time loading for big MIDI file).
Ignore CC32 for LSB Bank change (default for GS soundfont))
WebGL: subset generator for web, correct issue in GEN_STARTADDROFS, apply pitch at playing (Pitch Change). WebGL will be soon officialy available!
Correct soundfont importing with truncated samples name. Can conduct to samples missing. It's a rare issue but in case of you need to re-import your specific soundfont.

V2.14.0 2024-12-22

New Features

Unlock global volume up to 10 (by default, limited to 1). Add script symbols MPTK_UNLOCK_VOLUME to unlock. Experimental, use with caution.
Unlock MIDI player speed from 0.0001 to 100 (by default between to 0.1 and 10). Add script symbols MPTK_UNLOCK_SPEED to unlock. Experimental, use with caution.
Add optionnal wait time to MPTK_Stop for waiting until MIDI is really stopped.
Improve MPTK debug mode with MPTK_BuildInfoSynth.
Move Maestro menu to Unity Tools menu when MPTK_MAESTRO_MENU_TOOLS symbol is defined.
Soundfont caching is now optional when loading SF dynamically, see MidiPlayerGlobal.MPTK_LoadLiveSF (MPTK Pro).
Add MPTK_ResetTranspose to force cancel transpose when looping on a MIDI.

Demo & MVP

TestOboe: redesign (again!)
TestLoadingExternalSoundFont: redesign
Create MVP demo MidiKeyboardThread

Fix

Correct Oboe setting to correct bad sound on some devices (buffer not a multiple of 64).
Correct MIDI thread reader with OnAudio callback to improve accuracy.
Restore initial transpose value when looping.

V2.13.2 2024-11-13

Fix

Correct build error

V2.13.1 2024-08-11

Fix

Correct transposition error.

V2.13.0 2024-10-31

New Features

Based on Unity version 2022.3
MidiStream player: Extended to 256 channels.
MPTKWriter: Create MIDI until 256 channels (but not for writing). MPTK Pro.
MPTK_DebugActiveVoice added for advanced use.
Added new stat in MIDI file setup.

Demo & MVP

TestMidiExternalPlayer: Add measure calculation and innerloop capabilities, UI redesign. MPTK Pro.
TestOboe: UI redesign. MPTK Pro.
TestMidiStreamPlayer: Able to play with 32 channels.

Fixes

Replace obsolete method in Unity 6.
Correct synth attenuation range, limit to 1440.
HelperDemo: replaced method LabelC4FromMidi with method LabelFromMidi.
Now label centred in C4 (60 return C4). Removed LabelFromEcart method.
MPTKWriter: Correct TickLast. MPTK Pro.
Effect with oboe: process in blocks of 64, improve sound quality. MPTK Pro.
In folder MPTKGameObject/Pro, rename files MPTKEffect____.cs to MPTKEffect____Pro.cs.
In folder MPTKGameObject, create partial class MPTKEffect____.cs.
If an error occurs during the upgrade, delete the MidiPlayer/Scripts/MPTKGameObject folder before re-importing.

V2.12.1 2024-06-18

New Features

MPTK_ThreadMidiPriority: MIDI thread priority to improve reading stability.
MPTK_ThreadMidiWait: MIDI thread waiting in milliseconds.
IntegratedThreadMidi: MIDI reader integrated into the audio thread for more stable reading (can only be set by the inspector).
MPTK_CalculateTiming: Now, refresh all timing in the MIDI file: Tempo Map, Signature Map, Realtime, Measure, Beat.
MPTK_EventLastNote: Get the last MIDI event which holds a note-on.
MPTK_FindLastNote: Find the last MIDI event note-on.
MPTK_StopPlayOnLastNote: MIDI playing stop at the last note found in the MIDI.

Demo & MVP

TestMidiFilePlayerScript: new possibilities for "Modify MIDI And Play" feature and redesign.
EuclideanRhythm: light redesign.

Fixes

Correct MPTKTempo.FindSegment from a time (thanks cihadturhan_unity).
Correct MidiFilePlayer.Duration: now take into account the duration of the last note-on event (thanks Izanol).
Correct MidiThread Audio.

V2.12.0 - 2024-05-26

New Features

Update of the core MIDI synth from fluidsynth 1.3 to fluidsynth 2.3. Incredible new sound!
Ability to read and write META text with UTF8 encoding (out of MIDI standard).
DSP and iir filters in 64 bits.
Added MPTK_RawSeek function for instant looping.
Added MPTK_WebRequestError attribute for MidiFileExternalPlayer.

Demo & MVP

Added MIDI Viewer. Some colored line effects that move in relation to the music.
Added MVP demo TheSimplestRandomPlayer.
Added inner loop in TestMidiFilePlayerScript demo.
New MVP demo load midi and play.

Fixes

Oboe integration - correct assembly + some bugs.
Apply UI scale to all IMGUI demos.

Deprecated

MidiFilePlayer.MPTK_PulseLength deprecated, replaced by MPTK_Pulse.

New with V2.11.2 - 2024-02-07

Split MPTK sources in three assemblies for Demo, Editor and Run for better building perf.
Enhanced API for loading external SoundFont at runtime.
Add cache for external SoundFont loading at runtime.
Not mandatory to have a SoundFont for building an app.
Create demo load external SF from Demo Pro.
Add MPTK_StartSynth (could be usefull after a MPTK_StopSynth!)
Add directive UNITY_EDITOR to all editor scripts for better building perf.

New with 2.11.0 and bellow - 2023-12-01

MptkChannel centralize all members related to MIDI channel.
Member MPTK_Channels in MidiSynth (and children MidiFilePlayer, MidiStreamPlayer, ...).
MPTKEffectSoundFont (pro). MPTK_EffectSoundFont, MPTKEffectUnity (pro).
MPTK_EffectUnity in MidiSynth.
See detailed helper document for migration.
Move members MPTK_Channelxxxx from MidiSynth class to MPTKChannel class.
MPTKRangeLib has been renamed to MPTKScaleLib and globally all Range by Scale (pro).
MidiFileWriter2 renamed to MPTKWriter (pro) and simplified.
MPTK_EnableChangeTempo available in inspector for all prefab.
MPTK_EnablePresetDrum available in the inspector.
MPTKInnerLoop (pro), MPTKTempo, MPTKSignature
Measure/beat calculation capabilities
Measure and beat attributes calculated when a MIDI is loaded
Processing "System Real Time" MIDI events
MPTK_TempoMap, MPTK_SignMap, MPTK_CalculateTiming()
MPTK_DurationTickToMilli() and MPTK_DurationMilliToTick()
OnBeatEvent (pro)
Demo TestInnerLoop (pro)
Metronome with TestMidiFilePlayerScripting (OnQuarter event with pro)
Update demo TestMidiKeyboard for sending or receiving "System Real Time" MIDI event (pro)
Update demo TestMidiGenerator (simplification) + demo adding Inner Loop with META event (pro)Fix
ADSR calculation for a better sound.
Extraction sample which stop in some cases.
No MIDI playing in editor mode with MidiFileSetup.

Deprecated

MidiFileLoader, please consider using MidiFilePlayer.
MidiFileWriter2, please consider using MPTKWriter.

Maestro - Midi Player Tool Kit - Pro