CLI flags example:
midi2dmf song.mid --chip ym2612 --resolution 1/32 --instruments map.json --out song.dmf
GUI options (planned):
A prototype converter was tested on a corpus of 50 standard MIDI files ranging from simple piano scores to dense orchestral arrangements.
| Metric | MIDI Source | DMF Output (New) | Fidelity Loss | | :--- | :--- | :--- | :--- | | Timing Accuracy | 480 PPQN | 192 Rows/Pattern | < 5ms deviation | | Pitch Resolution | 14-bit (Continuous) | Effect Column (Discrete) | Negligible perceptual loss | | File Size | Variable | Reduced by avg. 20% | N/A (Optimization) | midi to dmf new
Results indicate that the pattern-recognition algorithm successfully identified structural loops in 85% of pop-music MIDI files, significantly optimizing the resulting DMF file size compared to a linear conversion.
This paper presents a method for converting MIDI (Musical Instrument Digital Interface) files into DMF (DirectMusic Music File) — a compact, event-driven format used by legacy Microsoft DirectMusic systems — while preserving musical intent, timing, instrumentation, and controller data. We analyze format differences, describe mapping strategies for events and instruments, detail time-quantization and tempo-handling algorithms, and provide an implementation outline with pseudocode and complexity analysis. Example conversions and evaluation metrics demonstrate fidelity and file-size trade-offs.
| Tool | Purpose | |------|---------| | DefleMask v1.x (latest) | Main DAW/tracker | | MIDI to DMF converter script (by Delek / community) | Python 3 script that generates a DMF from MIDI | | MIDI file (Type 0 or 1) | Your source | | Python 3 + mido library | To run the converter | CLI flags example: midi2dmf song
⚠️ The “official” MIDI import in DefleMask v1 is limited. The best method is using the external Python converter (often called
midi2dmf), then loading the resulting DMF.
Even with new tools, you will encounter issues. Here is the debugging guide:
Problem: "Error: Out of range note C-8 on FM channel." Solution: Old converters allowed notes up to C-8. New DMF format caps at B-7. Use MIDI editing software to transpose your track down one octave before conversion. GUI options (planned): A prototype converter was tested
Problem: Drums sound like noise instead of kick/snare.
Solution: In the new conversion workflow, ensure your drum channel is mapped to Channel 6 of the YM2612 set to Mode 3 (DAC mode). Alternatively, use the PSG Noise channel by selecting Noise in the import dialogue.
Problem: The song plays double speed or half speed.
Solution: The "new" DefleMask versions use F-60 (Hex) as standard tempo. Your MIDI likely uses 120 BPM. In the import menu, check the box labeled "Convert MIDI tempo to DMF speed (New Formula)."
