ConversionGuide - Turboxray/HuTrack GitHub Wiki

Conversion Guide

This page explains how to convert Deflemask .dmf files into HuTrack-ready assets and automatically generate the #incasmlabel statements for your C code.

Prerequisites

  • Python 3.x
    Download from https://www.python.org and, during installation, check “Add Python to PATH.”
    Verify in Command Prompt:

    

    cmd
    

    Copy
    

    C:\> python --version
Python 3.11.7

  • HuTrack repository cloned (the converter script lives in HuTrack/utils/).

All commands below assume Command Prompt (cmd.exe).

One-Off Conversion

Convert a single song:



cmd


Copy


python ./HuTrack/utils/HuTrackConverter.py ^
  --no_gui ^
  --filein   ".\music\Jazzya_Main.dmf" ^
  --songname "Jazzya_Main" ^
  --subfolder "Jazzya_Main" ^
  --includePath ".\songs" ^
  --no_songname ^
  --no_author
Placeholder | Meaning | Example -- | -- | -- --filein | Path to the input .dmf file | .\music\Jazzya_Main.dmf --songname, --subfolder | Identifier used for both the output subfolder and the C symbol | Jazzya_Main

With Python on your PATH and these commands in hand, converting and integrating music becomes a single-step process—ideal for quick iteration and automated builds.

Conversion Guide This page explains how to convert Deflemask .dmf files into HuTrack-ready assets and automatically generate the #include statements for your C code on Windows.

Prerequisites Python 3.x Download from https://www.python.org/ and, during installation, check “Add Python to PATH.” Verify in Command Prompt:

cmd Copy C:> python --version Python 3.11.7 HuTrack repository cloned (the converter script lives in HuTrack/utils/).

All commands below assume Command Prompt (cmd.exe).

One-Off Conversion Convert a single song:

cmd Copy python ./HuTrack/utils/HuTrackConverter.py ^ --no_gui ^ --filein ".\music\Jazzya_Main.dmf" ^ --songname "Jazzya_Main" ^ --subfolder "Jazzya_Main" ^ --includePath ".\songs" ^ --no_songname ^ --no_author Placeholder Meaning Example --filein Path to the input .dmf file .\music\Jazzya_Main.dmf --songname, --subfolder Identifier used for both the output subfolder and the C symbol Jazzya_Main

Resulting files

scss

.\songs\Jazzya_Main\ (binary data, tables, etc.)

Batch Conversion Script

Most projects convert multiple songs at once. Use the helper script (often named convert_songs.py) in your project root.

What it does

Deletes any existing song subfolders inside .\songs.

Runs HuTrackConverter.py on every .dmf it finds in .\songs.

Creates song_includes.c for direct inclusion in C

⚠️ **GitHub.com Fallback** ⚠️