File Formats

Configuration files

mtrack now uses config-rs for configuration parsing, which means we should support any of the configuration file formats that it supports. Testing for anything other than YAML is limited at the moment.

All YAML configuration files should include a kind field that identifies the file type. This allows mtrack to distinguish between different config types when scanning directories. Supported kinds:

  • kind: song — a song definition (song.yaml)
  • kind: playlist — a playlist definition
  • kind: hardware_profile — a hardware profile (from profiles_dir)

Files without a kind field are still loaded for backward compatibility, but adding kind is recommended. Songs with kind: song that fail to load will appear as errors in the web UI so you can fix them.

Audio files

mtrack supports a wide variety of audio formats through the symphonia library. Supported formats include:

  • WAV (PCM, various bit depths)
  • FLAC (Free Lossless Audio Codec)
  • MP3 (MPEG Audio Layer III)
  • OGG Vorbis
  • AAC (Advanced Audio Coding)
  • ALAC (Apple Lossless, in M4A containers)

All audio files are automatically transcoded to match your audio device’s configuration (sample rate, bit depth, and format). Files can be mixed and matched within a song - for example, you can use a WAV file for your click track and an MP3 file for your backing track.