Midi2Uge hUGETracker Midi Converter
A downloadable tool
Convert midi files to hUGEdriver format (uge) for use with your GBDK, GB Studio, RGBDS projects. Includes an extensive manual on how to prepare midis downloaded from the internet, refine the initial mapping and perform post conversion cleanup as well as a preview ROM of the default instruments.
Works standalone in Windows and with Python install on Mac or Linux. Produces UGE for hUGETracker v1.x or higher (doesn't work with beta 9 for older Gb Studio versions).
No coding or digital audio workstation experience required!
Disclaimer:
Some midis simply do not convert properly. If you are downloading midis of popular songs it is suggested you try various versions to find the best results. The best results come from prepping midis as described in the manual or at least using user-aided mapping.
If you are planning to import a single song and going to be very upset if it doesn't work perfectly, message me on Discord @beatscribe, I will let you know if it converts well and give you some manual mapping tips. I'd rather have this than someone asking for refunds.
Extensive testing has shown the following:
- Auto-mapping - 25% success rate
- User-aided manual mapping - 60% success rate
- Pre-cleaned/Edited MIDI + User-aided manual mapping - 80% success rate
Converted .UGE files work with the latest versions of RGBDASM, GBDK and GB Studio version 3.2.1 or higher (must support hUGEDriver 1 or higher, not beta 9).
Watch tutorials from Beatscribe here:
Part 1 - Cleaning up a Midi before conversion
Part 2 - Conversion and Post-Conversion Cleanup
Created by :
Beatscribe
Ravi P
Here's a video of the chord to ARP converter in action!
Additional support from Superdisk.
Artwork by sjd.
Font in test ROM from 2bitcrook's Font Pack.
Full disclosure: I wrote this from scratch but I did use Claude AI to add some features.
Purchase
In order to download this tool you must purchase it at or above the minimum price of $9 USD. You will get access to the following files:
Development log
- Version 2.7 - Midi Clean Option and Polyphonic Mode!22 days ago
- Version 2.6 - Auto Octave Adjustments and Transpose Song30 days ago
- Version 2.5 - Bug Fixes90 days ago
- Version 2.4 - Chords to Arpeggio Converter96 days ago
- Update Midi2Uge 2.3 - Split Long MIDIsJan 16, 2026
- Version 2.2 released - Note Cuts!Jan 15, 2026
- Version 2.1 Released - Now Imports Velocity!Jan 11, 2026
- Version 2 ReleasedJan 08, 2026
Comments
Log in with itch.io to leave a comment.
I had to make an account to state this. 0/10. I brought this unaware that you required a paid APPLE product to actually get all the midis I need to use to work. Refund. Thanks for the heads up, NOT.
hey my dad loves those NOT jokes too. Since you were so unclear in your complaints, I have to assume you mean logic pro? As stated in multiple places, you can use reaper as a free alternative. Any software that can edit an export to midi does the trick. I just showed Logic Pro as an example.
Best program ever for us who work making music for GB Studio games, and the support is top-notch. The new updates added so much more, and I'm excited for new versions, but so far it's been a huge time saver. Thank you!
Hoping Genesis/MD compatible MIDI -> .VGM for the XGM driver becomes low hanging fruit. I'll make sure to let MD homebrewers know if it becomes a thing :)
are you asking if i could make that?
Suggesting adding Genesis XGM export as a feature. Could probably use parts of the existing XGM Tools included in SGDK.
msg me on discord (beatscribe) ill see what I can do.
Thank you for considering it! I "follow" you here on Itch for updates on Midi2Uge. Unnfortunatly, clicking on the "I can also be reached on Discord at:" link just takes me to my own Discord profile. Is there an invite generation link I'm missing? In any case. Maybe the XGM folders here would be helpful. https://github.com/Stephane-D/SGDK/tree/master/tools
just add Beatscribe on discord , if you can help me work a testing framework I can possibly make it fairly easily
Running on Windows and I'm having an issue where it pops up and disappears without doing the conversion. Any ideas what's up?
are you dragging the files to the bat file?
Yea
if the .uge.mid does not appear after , you might need to run the command line version to see if there’s any issue
Thanks. I must admit, I'm not really sure how to do that. but I'll look it up
Sorry it’s not the easiest but if you msg me on discord with your midi file I’ll let you know if something is wrong.
Awesome thing. Can You make version that cuts long midis into few uges?
that might be tough but I’ll look into it. Maybe an offset command to start at a certain measure , it looks at it all very sequentially tho ..for now you could use a DAWs to chop the midi up and export it in chunks for this to read
the latest version now supports this!
Is there some special option or something? Because it doesn't work for me.
it’s automatic , after 27 patterns, did you download new version 2.3? That msg is no longer in version 2.3 so you must not have the latest
You are right I had v2.0, in 2.3 it really works, awesome job.
I’m glad!
Hi, Does this work with midi files exported from a DAW? If it does is there any info in the manual?
Yes it works best with midis exported from professional daw like Logic Pro or Cubase. You can also use reaper which is free. The manual has a whole section on that and how to get best results.
Thank you! I will certinly check it out then :)
this is so helpful. its worth the money.it might make it way more fun to make games.
glad you like it!
It seems cool, but to be honest I want it to be free. I don't wanna pay for this at all
to be honest I don’t want to charge , or pay rent or pay for food
Works really well, this is going to be such a huge help!
I'm so glad its working well for you!
Thank you for your efforts! Just bought this. I was using OpenMPT to convert midi to mod there, but now after going through your tutorials on GBStudio Central and seeing how dynamic hUGETracker is, I'm switching over :).
Thanks!! After one midi to openMPT copy paste to hUGEtracker marathons I just had to build this!
Huge help man, this saves me soooo much manual transcription time! Thank you for your continued contributions to the community!
im so glad you like it! It’s a game changer for me personally too!
This makes stuff so easier for me thanks for this tool beatscribe!
I’m glad you enjoy it!!
I already trust this so of course I buy this one ! Just did! Let me study the software and I'll be back with feedbacks!
Thanks. We will probably make a version 2 so if you find anything particularly bad, let me know. However, also keep in mind auto-convert is very hit or miss (thats why I show the Dr Wily auto convert going totally wrong in the video, and how to fix, I want to be honest).
Any chance for a linux version too?
This one is! Check the PDF, you just need to install python. It has all the command lines included. Tested in various Linux systems too.
That's awesome. Thank you for answering!
no worries let me know if you have any issues