DOCUMENTATION

FR | EN | Home

BASIC PRINCIPLE

You will organize your set in the ./data/songs folder.

  • One directory per song
  • Your backing tracks in the ./audio folder
  • Your video clip in mp4 format in ./clip/clip.mp4
  • Optional: an XML file describing the song structure and MIDI commands (useful to visualize playback position, or start playback on a given verse/chorus).

This “handmade” approach, although it may seem tedious at first, ensures a clear and lasting organization of your set, making it easy to maintain and share.

Example:

songs/
├── 01_Bohemian_Rhapsody/
│   ├── structure.xml
│   └── audio/
│   │   ├── backing.wav
│   │   └── click.wav
│   ├── clip/
│   │   └── clip.mp4
└── 02_Sweet_Child_O_Mine/
    ├── structure.xml
    └── audio/
        ├── backing_stereo.wav
        ├── organs.wav
        └── metronome.wav

To get started, Tonton Media Player comes with two example songs.

SONG STRUCTURE (optional)

Describes the duration, bpm, name and MIDI controls for each section. Tonton Media Player only reads the file, so it remains safe from accidental manipulation and easily recoverable.

<structure>
    <songparts>
        <songpart>
            <desc>Intro</desc>      // description/name to display
            <bpm>120</bpm>          // beats per minute
            <length>32</length>     // duration, in beats
            <program>A01</program>  // Elektron format name (Model:Cycles, Digitakt, etc.)
        </songpart>
        <songpart>
            <desc>Verse</desc>
            <bpm>120</bpm>
            <length>64</length>
            <program>A02</program>
        </songpart>
        <songpart>
            <desc>Chorus</desc>
            <bpm>32</bpm>
            <length>32</length>
            <program>A03</program>
        </songpart>
        <songpart>
            <desc>End</desc>
            <bpm>120</bpm>
            <length>4</length>
            <program>A04</program>
        </songpart>
    </songparts>
</structure>

Elektron sequencers: You can use real pattern names (A01, F15, etc.) instead of numeric MIDI values.

MAIN CONFIGURATION FILE

The ./data/settings.xml file allows you to configure Tonton Media Player:

  • Songs path - Default: data/songs/
  • MIDI ports - Configuration of MIDI devices you want to control

<settings>
    <songs_root_dir>./songs/</songs_root_dir>             <-- Absolute path, or relative path from ./data

    <midi_outputs>
        <output>
            Elektron Model:Cycles sequencer
            <name>MC</name>
            <device_id>Elektron Model:Cycles</device_id>  <--Name as it appears in Windows/macOS
            <channel>10</channel>                         <--Channel to send Program Change
            <input_format>elektron_pattern</input_format>
            <send_ticks>1</send_ticks>                    <--Drives the device metronome
        </output>
        <output>
            Elektron Digitakt sequencer -->
            <name>Digitakt</name>
            <device_id>Elektron Digitakt</device_id>
            <channel>10</channel>
            <input_format>elektron_pattern</input_format>
            <send_ticks>1</send_ticks>
        </output>
        <output>
            Controlling a VST in Reaper (sending MIDI via macOS IAC Driver)
            <name>ChantLead</name>
            <device_id>IAC Driver Bus 2</device_id>
            <channel>10</channel>
            <input_format>patch_name</input_format>
            <patches>
                <patch>
                    <name>clean</name>                     <-- Patch name
                    <program>0</program>                   <-- Program number (0-127)
                </patch>
                <patch>
                    <name>autotune</name>
                    <program>1</program>
                </patch>
                <patch>
                    <name>reverb</name>
                    <program>2</program>
                </patch>
            </patches>
        </output>
    </midi_outputs>

</settings>

Need help with your configuration? Contact us, we'll be happy to guide you or provide a pre-configured version for your needs!

WORKFLOW

Once your folders are structured:

  1. Open Tonton Media Player
  2. Check your audio outputs
  3. Launch your first song

TIPS

  • ALWAYS TEST your setlists before the gig
  • BACKUP your files
  • KEEP IT SIMPLE - The clearer, the better
  • AUDIO FORMAT - FLAC preferred (lossless, faster loading), WAV (slower loading), or MP3.

TROUBLESHOOTING

  • No sound → Check your audio outputs
  • Latency → Reduce buffer size
  • Missing files / Song not loaded → Check your file structure
  • MIDI acting up → Check port and channel
  • Lagging → Close other apps