Midi Player Tool Kit - Good news for your rhythm game !

Please leave a kind review on the Asset Store. It's very motivating!
Assets: Free MPTK and Pro MPTK

Info October, 11

• Version 2.89.1 is available!. It's a patch version, some fixes and quick enhancements.
  • Add helper link for the MidiFileLoader inspector and a related page on the web site.
  • Add delayed start to MPTK_Play (Pro version)
  • Add delayed stop to MPTK_Stop (Pro version)
  • Add short script demo for MIDI looping
  • Correct instantiation for all MPTK OnEventxxxx to avoid crash in rare cases.
  • Corrected: Preset change for channel 9 was disabled
  • New kind of demos are also available: MVP (for Minimum Viable Product) has just enough core features to effectively deploy the product, and not more. Very efficient to understand how using Maestro.
    • MVP Free: MidiLoop and TheSimplestMidiLoader
    • MVP Pro: Spatializer3D for spatializing MIDI by tracks in a few lines of code

Info September, 6

• Finally it's a version 2.89.0 because there is a lot of new functions! See below:

• OnMidiEvent can be used like a preprocessor of the MIDI events: it's possible to change the value of the MIDI events in real time . [Pro]
• MPTK_TransExcludedChannel method useful to exclude a channel for transposing (in general, channel 9 for drums).
• MPTK_keepPlayingNonLooped properties: when set to true, NoteOff or Duration for non-looped samples are ignored and the samples play through to the end.
• Synth rate can be set to any value from the inspector or with MPTK_SynthRate.
• Output rate and buffer size can be modified when playing but only for test purpose.
• Added changing output rate and buffer size for iOS, but stay experimental.
• MPTK_ChannelPresetChange: apply bank and preset change even if not available but return false.
• MPTK_ChannelForcedPresetSet: apply bank and preset change even if not available but return false, able now to force bank.
• MPTK_RealTime properties: real time since the start of the MIDI.
• MPTK_KeepEndTrack properties: when set to true, meta MIDI event End Track are keep. Default is false.
• MPTK_TickLastNote properties: tick position for the last note-on found.
• MPTK_PositionLastNote properties: real time position in millisecond for the last note-on found in the MIDI.

See Version release for a full description.
Have Fun!​

Info August, 24

• version V2.88.3 is in progress ... will be available beginning September.
• New site for API doc: https://mptkapi.paxstellar.com/annotated.html

Info July, 23

• Interesting!
• https://discord.com/channels/671365299756466199/673061158713950249/868198745190322186

Info July, 19

• version V2.88.3 in progress ...

Info June, 21

• Oyez! Oyez! Version 2.88.2 is available!
• Very important, please read if you have issue when updating: package manager is buggy with some Unity versions. Try to use the latest LTS Unity version possible. For today:
  • With Unity 2020: LTS Release 2020.3.12f1,
    
  • With Unity 2019: LTS Release 2019.4.28f1

Info June, 18

• Finally, we choose Unity 2019.4.28 to ensure a good stability. Obviously, Maestro remains also compatible with higher Unity versions.
  
• We hope the version 2.88.2 will be available beginning newt week.
• Have Fun!

Info June, 17

• Finalizing the spatialisation by tracks took longer than expected ... but the version is now ready.
• Helas, we got a minor setback when publishing version 2.88.2 with the 2017. Unity team say : "New assets should not be submitted through Unity versions earlier than 2018.4.0 LTS"
• While we are at it, we decided to move Maestro to a recent Unity version: the LTS 2020.3.0 or 2019.4.28.
  
• We hope that any developers need to use an earlier version !

Info May, 22

• Version 2.88.2 on the road!
• Get a look here on this discord server dedicated to Maestro app's. It's a funny place for talking about new version, explain your need, exchange between users. But I'm a newbie with discord, I need your help to animate this server and your advice. You are all welcome!!!
• Some new methods added:
  • MidiFilePlayer.MPTK_ReadMidiEvents
  • MPTKEvent.MTPK_GetSynthParameterDefaultValue, MTPK_GetSynthParameterLabel, MTPK_GetSynthParameterListGenerator, MTPK_ClearSynthParameter [Pro].
  • MidiFileLoader.MPTK_SearchMidiToPlay
• Demo SpatializerFly: new look and capacity to defined 3D sound by midi tracks on top of midi channels.

Info April, 19

• Version 2.881 is available! Fast review!
  
• A user report some difficulties to update with this new version. Contact me if you have difficulties or error after updating. Unity Package Manager seems not absolutely reliable.
  
• Main new functions
  • Midi Meta Event KeySignature and TimeSignature are now processed!
  • Look at the new entry in the MPTK menu: version detail and quick access to documentation and a new windows give a quick access to the 15 demos available.

Info Marsh, 23

• Version 2.88 is on the way !
  • Soon, a little change for the name "Midi Player Tool Kit" name ... to be continued.
    
  • Always more accuracy for the midi player:
    • Better calculation of the real time of each midi events . Now, takes into account Tempo Change.
      
    • A new properties with each midi events give you the time of the event. See RealTime in MPTKEvent class.
  • A lot of improvements for MidiFileWriter2!!!
    • Get automatic creation and ending of tracks.
    • Create a list of midi events and play it with the internal MPTK midi sequencer (no temp file created).
      
    • Dedicated methods to create each kind of midi event
  • Thanks for your comments, talks, mails, that help me to make MPTK better!!!

Info December, 29

• Version 2.87 Pro is available !
  
• New features available :
  • New MPTK event triggered by the audio engine. Absolutely essential if you are writing something like a sequencer or a rhythm game. Generated Music becomes very accurate !
  • Read a full description here.
    
  • Update of the "Midi Euclidean Rhythms" demo. Mainly to check the added event but also with a lot of good function to play music.

Info December, 02

• Oyez! Oyez! version 2.86 is available. Thank to a very quick validation in 3 hours by the Unity team this morning.
• Main new features:
  • Android: Ready to fight latency with the integration of the Unity asset Oboe. No code to write, just bought Oboe! [Pro].
  • Synthesizer: Real time synth parameters modification. Now you can hange the default SoundFont generator value (ADSR, LFO, Effect, ...) by script for each voices [Pro].
  • Midi Device: To reduce latency with Midi keyboard, add possibility for reading midi events from a device with a callback [Pro].
  • See "version change" for other features.
• Look here for Oboe integration in MPTK https://paxstellar.fr/oboe-fight-android-latency/

Some screen shot ...

Synth parameters available for real time change:


This demo (with MPTK Pro) is useful to test latency but also the MPTK synthesizer voices run time effects and running different players at the same time. So, there is two prefabs MidiStreamPlayer for the drums and one MidiFilePlayer for the midi running at the same time.

An APK is available for those who want to test on their Android. Ask me by email, i will send you a link to the APK Euclidean Rhythm. Of course, I would be very happy to have your return.

Info November, 16

• • New class MidiFileWriter2 but the previous (MidiFileWriter) is maintain until the next major version. MidiFileWriter2 proposes a more consistent behavior with the others classes of MPTK and new helpful functions.
  • Warm your keyboard! https://paxstellar.fr/class-midikeyboard/ Midi output device capabilities on top of Midi reading has been added [Pro]. As usual, a demo (simple) is available.
    
  • And as usual, some issues corrected, see Release Notes.
  Have Fun!

​

Infos october, 02

• We had a talk with a person wondered if a sequencer is available with MPTK. The answer is yes and no! Yes there is a Midi Sequencer able to play Midi file in background, and no, there is not an User Interface to create you own sequence. We considered that there is a lot of free sequencers able to do that better than with Unity which is limited with it's Graphical User Interface (GUI). But the question is open! Please, give your opinion if you think that a GUI Sequencer in MPTK could be interesting. Thank by advance for your response.

Infos september,18 (a lot of news!):

• Please, have a look to this Important update on the MPTK web site : Scripting with MPTK. I hope that will help persons who want to develop scripts with MPTK.
• If you want to update MPTK to 2.841, please remove your previous version: delete folder MidiPlayer from the project tab. I apologize for that, but sync update don't remove source file which are deleted in the new version, so conflict are detected.
• Version 2.841 s available on the store

• Horrible! The design of the two editors windows, Midi File Setup and Sound Font Setup, was ugly with Unity 2019 and 2020. Thank Unity to modify the default style of GUI!!! Corrected with this version.
• You often ask for this function: add all Midi from a folder. Done!

​

New design for Midi File Setup and Sound Font Setup




Version 2.84 is available on the store

• Now switching between Midi playing is immediate.
• Add functions to facilitate integration with Bolt [Pro]
• Start and Stop playing gradually (ramp-up) [Pro].
• Now Midi play also with Time.timeScale = 0.
• And globally, a lot of enhancements on the demos (7 for free, 6 more with the pro version).

Have Fun !

Version 2.83 is available on the store

• This version adds great enhancement for spatialization. MPTK is ready for Virtual Reality and Augmented Reality applications
• The spatialization by channel/instrument [Pro] defined the position of each instruments in the 3D world.
  
• Have a look the the video below: you can fly inside a whole orchestra and listen for each instrument individually. The demo is available with the Pro version.

Main 2.82 new functions:

• Builder for music range and chord which is useful for algo music - [Pro]
  
• Integration with PlayerMaker and Adventure Creator - [Pro]
  
• Spatialization capabilities, ready for your Virtual Reality project. [All versions]

Main 2.81 new functions:

• Add fluidsynth effects for standard SoundFont effects and integration with Unity effects [Pro]
• Add integration with Cinematic Sequencer - Slate [Pro]
  Watch here a quick tuto:

and the dedicated page on the MPTK web site.

Version 2.7

• Midi Sequencer totally rewrited from the awesome fluidsynth: better processing of midi pause, change position, change tempo, speed, ...
  
• Separate thread: better performance for complex Midi when a lot of samples are played simultaneously. Parameters are availables to adjust the level of performance need.
• Load SoundFont from the web or desktop while running. It is no longer necessary to load the SoundFont in the DB before playing [PRO]
  
• Start playing from the first note.
• Pause when focus loss. Essential for smartphone !
• Set default interpolation mode to Linear for a better sound (previous version was set to None).

Also, for advanced needs, three preprocessors directives are available to help understanding the performance:

• DEBUG_PERF_AUDIO
• DEBUG_PERF_MIDI
• DEBUG_STATUS_STAT

The demo TestMidiFilePlayerScripting has been adapted to display the performance KPI.


Version 2.65 available:

⭐ Add Midi input functions (Windows and MacOS only) [PRO]. Thank to the new Prefab MidiInReader and the API to read a Midi keyboard. Integrate your Midi keyboard in a few clicks!
⭐ Change Unity Audio buffer size and synth rate for again better tempo accuracy, better sound, low latency.
⭐Full rewrite of the MidiListPlayer Inspector [PRO]. Now you can play part of a Midi, choose time to start and stop, choose overlap before the next Midi in the list.
⭐See also the new demo based on Euclidean Rhythm Algo. It's a rhythm box that could become a complete application.
⭐ Preview of the new Midi file setup : new function to analyze the midi file, new design of the page, ....
⭐Correct an issue with the Sustain control which can generate CPU overload
⭐Add Pitch change midi event

See below demonstrations ...

Build a Rhythm Box:

Build a Midi Game:

Midi Player Tool Kit is a package able to play music from Midi files in your application or from your own algo. There is no need of external component or device.

Thank to SoundFont for adding hundred sounds of instruments for playing Midi files

• No scripting C# or JS is mandatory: specific inspector defined all your needs directly in Unity editor. See an overview here (V2).
• Add Midi Audio Source Prefab in your scene as much as you want.
• Add Midi files (from the web or from your composition) as much as you want.
• Play / Paused automatically based on distance.
• API available (V2) to integrate MPTK in your application.

Version 2.7 beta on the road, could be available beginning February

⭐Add capabilities to load soundfont on the fly from local device or from the web [PRO]. It's now possible to use MPTK without loading a soundfont in the resource folder.
⭐Add new attributes to evaluate accuracy and performance for Midi Playing and SoundFont Synthesizer.
⭐Midi Sequencer and SoundFont Synthesizer are now autonomous (played in separate thread): more accuracy, better performance.
⭐Replaced deprecated WWW method with UnityWebRequest for MidiExternalPlay prefab [PRO].
⭐Corrected timing accuracy with MacOS.
⭐Corrected bad sound when changing tempo or position when playing



Have Fun !

 

Hi
Version 2 available. Check API here.
Have Fun !

 

Hello Bachmann! Thank you for the interesting asset. You write: "...Midi Player Tool Kit converts SoundFont to a simpler format with not all the functionalities of SoudFont..." Would you please tell, which exactly functional of SoundFont is modified in Unity, or will be not available?

 

Hi Denis2018m,

Included : key range, velocity range, pan, sample, loop sample, OverridingRootKey, FineTune, CoarseTune
not included : ADSL, Chorus, Reverb, Frequency Modulation

Mainly, all heavy CPU consumming generator are not implemented.
[Edit: All functions now implemented in MPTK V2!]

Best regards

 

Is there a way to dynamically "feed" the player with data instead of sending a prebuilt file?
for example, what if I want to play a few chords instead of an entire song?
thanks,
Mark

 

Hi
If I well understand your question, you want to play music without a Midi file ?
The last version 1.5, can be used to play notes with the API. For each notes you have to defined : note, instrument, duration, volume, ....
Have a look to this two demo in the package :

• TestMidiStreamSimple : very simple (and horrible!) music generator. Usefull to understand how to use the MidiStreamPlayer Prefab.
• TestMidiStreamGenerator : a more complex music generator with some algorithm. Could become in futur a new asset in the store ;-)

BR
Thierry

 

Hi,

interested in the plugin for the music tiles type game. The api link is broken to see if it would be possible.

Regards

 

Hi,
I apologize for this broken link. A new release has been published monday, I hope it would be available soon on the Unity Store.

Here the new url : https://paxstellar.fr/

BR
Thierry

 

Hi
API here :
https://paxstellar.fr/

 

Hi BachmannT,

I'm very happy that there is a free midi toolkit in asset store, I tried it but found a problem. Is the OnEventNotesMidi event only appear in PRO version? I can't find it in free version.

Thank you very much!

 

Hello wangzy_88,
I'm happy if you are happy !
I can confirm that OnEventNotesMidi is also available on the free version.
I'm publishing a new version today (1.7), you could have a look to the new demo "Demo CatchMusic" where this event is used.

Best Regards
Thierry

 

Hello
The OnEventNotesMidi will be available with the version 1.7
The documentation was incorrect : see now here https://paxstellar.fr/

Version 1.7 will be available soon (published on Unity store June, 29)

Have Fun
Thierry

 

Hi Thierry,
Thank you for your answer!
I can't find the 1.7 version now but I think the reason is asset store has upload delay. Anyway I'll watch it

Have a good day!
wangzy_88

 

Hi
1.7 available !
Thank to Unity for the efficient publishing process !

 

Hi Thierry,

I tried the 1.7 version and I must say it's very good! The new demo is interesting too!
Now I have two new questions:
Can I read the notes of midi without playing it?
Can I get the real time(since play start) of note? I found that the AbsoluteQuantize isn't what I want.

Thank you!
wangzy_88

 

Hi wangzy_88

Yes ! from the inspector of MidiFilePlayer, have a look to "Direct Send to Player". If not checked, no sound are played.
From the script, use properties MPTK_DirectSendToPlayer of a MidiFilePlayer component.

Yes ! Have a look to this properties of MidiFilePlayer.
/// Time from the start of playing the current midi
public virtual TimeSpan MPTK_PlayTime

it's a TimeSpan, use MPTK_PlayTime.TotalMilliseconds to get the time in milliseconds

ps: thank for your good comment ;-)

Best regards
Thierry

 

Haha, I'm happy that you like my comment!
And what I really want to do is read the midi info in Editor, I want to let midi file to tell me the notes, but player will listen mp3 or wav, they sound better than midi.
Anyway I can play midi once and record the info, but if you have a better suggest, I'll be very happy.

PS: I found another way, use ReadMidiEvents() in MidiLoad, but I can't get the real time too.

Have a good day!
wangzy_88

 

Hi,
Is there a way to do the following process with this kit?

• transposing (changing) key of music
  
• mapping each channel of MIDI to a specified channel of output device
  • I want to map each instrument to each channel of 7.1ch surround output device.

Thanks,
yamomoniy

 

Hello yamomoniy

For your questions :
1) Yes, MPTK can transpose key of music. See inspector of MidiFilePlayer or API if you want also to transpose by script.
2) No, for mapping each channel of MIDI to a specified channel of output device. MPTK don't use midi device to play music.Music is played with waves extracted from Soundfont. No need of external device. But, could be an idea for a future version !

Best regards
Thierry

 

Hello Thierry-san,

I see. Thank you for your kind support!

Best regards,
yamomoniy

 

Hi Thierry,

I've just found your asset and it looks very promising! Thanks so much for sharing it!

I'm now studing the code and I'm trying to find a way to get a frame rate indipendent and sample accurate player, maybe implementing it into OnAudioFilterRead.

I'm developing a rhythm game so my needs are:
1) Sync a background music track (wav, mp3, whatever)
2) Play MIDI and get events to handle gameplay

Since the gameplay is music based, the MIDI has to play no matter what, even if the frame rate drops drammatically, so I can't rely on WaitForSeconds because it's fps dependent.

I'll share my solution with you if I find one

Thanks again for your hard work!

Best,
Alex

 

Hi alexrshare
Seems a very good project that you have ! And thank for your kind comment.
Have you see the demo CatchMusic in MPTK ? It could be interesting for you : a midifile is loaded but midi events are not played immediately. A unity event is defined to receive list of midi events at each midi ticks (if there is midi events!). So you are independant of frame per second.

Best regards
Thierry

 

Hi Thierry,
thanks for your reply!

I've already seen CatchMusic demo.
Setting "V Sync Count" to "Don't Sync" in Quality Setting and, just for testing, adding
Application.targetFrameRate = 1;
in Awake method, of course the video is refreshed every 1 second but also the MIDI is played every second, which is what I want to avoid.

Best,
Alex

 

hi 。can i play guitar bass drum three instruments with one sound？how can i do that 。
editor sound font only can select one instrument 。。

 

i got i must join sf2 together to use ，but how can i use them split？

 

Hello, split defined in SF2 are also managed by MPTK

 

Hello, I don't understand "can i play guitar bass drum three instruments with one sound". Could you be more detailed ?

 

Any plans to support the sfz format?

 

Hi, one try have been done.For now I have an issue with the wave format of SFZ.

 

yes。details i know how to do that!
but i have one requirement。how can i play one song to a midi file
this plugin can do that？
i play some key just like c d e f g then i can export to a midi file out put？

 

I scrolled down a few pages and I do LOVE what you've done with the MIDI Toolkit.

 

Hello
No, MPTK is not a Midi Sequencer able to take your input to create Midi. MPTK is a Midi file reader to play music. BR

 

You are welcome ;-)

 

ok but i need to record music by note! can you show me some roads？

 

Ok, perhaps I better understand your need. It could be an interesting function if you are using MPTK to generate note in real time. I will plan this evolution as soon as possible.
Best regards

 

thank you ！ five stars wait for you！ (。-ω-)zzz
and i will try ，found have some code on you code，maybe it can work
just like MidiEventCollection PrepareForExport

 

;-)

perhaps, you could contact me on my private adresse mail (see MPTK Unity Store) to better describe your project. Writing midi file is not a complex task, technically speaking, it's more tricky to understand how integrate this function with MPTK and keep consistency of the whole. There is a lot of approach possible ! Thank.

 

Hi all
The version 1.9 Pro is waiting for the Unity review. Could be available in a few days. New functions available:
Added new MidiListPlayer GameObject able to lead Midi play list
Added new class to write Midi file from MPTK
Added capacity of playing multiple waves for one note when SoundFont contains overlapped zone
Added processing of the Panoramic SoundFont parameter when playing waves
Added processing of the Attenuation SoundFont parameter when playing waves
Added ReleaseTime change with MidiStreamPlayer Inspector

And a lot of enhancement !

Have Fun

 

I REALLY like what you have built and intend to use it for several music games. But, when I create a midi file
using Band In A Box, and play it using the Free MPTK, it sounds like an old fashioned midi game from the 1990's. But, when I play the same song on my computer as a midi file, it sounds full and correct. Is this caused by the soundfonts used in the free version? If I purchase the PRO version will this allow me to select fonts which will sound more natural and professional?

 

Hello I'm sorry for the delay in response. There is no Unity notification when a new comment is publish.

To answer : MPTK use a simplified SoundFont model to avoid heavy calculation and installation of other components. Some Midi don't sounds like a synthesizer or a computer but generally, the sound is good !

Please send me your Midi or a link, I will have a look to understand the issue.

I'm working on a version 2 to implement some effects as filters, chorus, adsr, … to get sounds near a classical synthesizer, it's quite complex ! So, the price of the Pro version will increase ... of course with no change for current owner of the Pro! They will get the update for free.

 

Hello all,
I have temporaly deprecated the MPTK package to correct an issue. Will be available soon !

 

1.93 available !
Corrected an issue : the path to the SoundFont was lost when changing the project path.

 

can you please guide me how to work with this plugin?

 

Sure ! but your question is quite large! Have you read the documentation here ?
Have you some specific questions ?
Best Regards

 

Does this give you access to the lyrics embedded in midi files to display then while the song is playing ?

 

How to use this plugin for piano tiles game? We need to generate tiles according to the midi note's duration

 

Yes ! the lyrics are displayed in the Inspector. You can also get them by the API: MPTK_TextEvent from MidiFilePlayer object.

​

 

If I well understand, you want to generate some graphics asset (piano tiles ?) with notes (duration) from a Midi ? Have a look to the demonstration in MPTK package: CatchMusic


Also, I'm working on a more interesting version that could be on Unity as a other package:

 

Hi. Defaut Alto Sax [065] can't play in correct time. But the Soprano Sax [064] can play.
My environment is Midi Player Tool Kit For Unity free with Unity2018.2.14f1.
I used MidiStreamPlayer.prefab.
I find Audio Source of Soprano check "Loop", but one of Alto don't.
Finally, your asset is very easy to use. Thanks!

 

Hello rn9dfj3.
Thank for your comment ! For your remark, I will check this asap, but i'm going in holidays tomorrow, so perhaps not before one week.
BR
Thierry