mTooth icon

mTooth User's Guide


  1. Overview
  2. Displays
  3. Band Tool
  4. MIDI Import Options
  5. Tips
  6. Files
  7. Known Problems
  8. Version History
  9. Contact and Credits

1. Overview

mTooth plays music written in the text format needed by bards in the Clan Lord game. It can also transcribe MIDI 0 files to that format, and it can partially convert MIDI 1 files. mTooth runs in OS X only.

Key Features:

  1. Write music that conforms to the Clan Lord requirements.
  2. Get the music into mTooth.
    • If it's already in Clan Lord format, write it or paste it into an empty mTooth window.
    • If you wrote in another format, get it into MIDI 0. Melody Assistant's "Export as MIDI 0" command works well, although it does occasionally mess up. Then open the MIDI file in mTooth.
  3. Edit it until you like it.
    • If you're importing from MIDI, adjust the import options until you're happy with the result. Click the tabs to see the effects of your choices.
    • Edit the text and play the song until it's in final form. If part of the Music field is highlighted (selected), only the selected portion will be played.
    • Use the Band Tool to play two or three songs at the same time as a duet or trio.
  4. Save your file in one of two formats:
    • mTooth file: to be read by mTooth again. This is the default format. If you imported your song from MIDI, mTooth will remember which MIDI file it was using so you can adjust the import options more later.
    • Text File With CL Formats: Available with "Export...". This is a plain text file with the contents of the Music pane, plus the same music formatted for use in Clan Lord macros and in writing the song to sheet music.

2. Displays

An mTooth window has two tabs, showing two different kinds of information about your music. At the bottom of the Music tab are the instrument selection, an area for messages, a Play button, and a round button to show or hide the MIDI import options. The Play button will play only the selected portion of the music. To play the whole song, make sure nothing is selected. Click anywhere to stop the song.

If you imported your file from MIDI, the Music tab will also include several informative comments:

3. Band Tool

The Band Tool, in the Window menu, lets you choose up to three songs from open windows to play at the same time as a solo, duet, or trio. If part of a song is selected in its window, only that part will be played. Each one can also be turned on or off using the checkbox to the left of its name. Click anywhere to stop the music.

4. MIDI Import Options

Each open file that was imported from MIDI has its own options to control how it is converted and displayed. Click the round button in the lower right corner to show or hide the option panel. Your option choices will be saved with your music file, so you can keep working on them later. Click "Apply" to apply your option choices and re-display the converted music, reloading it from the MIDI file first in case it's changed. Click "Defaults" to get rid of your choices and restore the default options.

Transpose the entire song up or down by this many half-steps. This may affect the starting octave, and it might move notes into or out of the allowed range for the instrument.
Octave shift
If the box is empty, mTooth will automatically mark the lowest notes in your song as octave 0 (Clan Lord's "\" octave). If you're splitting channels, the lowest note in each channel will be considered separately. If there's an octave shift entered into the box, that will be applied to every channel instead (including a shift of 0, which will make "\" apply to the octave below middle C).
Volume shift
If the box is empty, mTooth will automatically shift the song so that the loudest notes are volume 10. This is like turning up the volume on a stereo, not spreading the dynamic range out. If your song contains volumes 5 and 3 (i.e., 50% and 30% of the possible maximum MIDI volumes), they will become volumes 10 and 8 after automatic adjustment. If there's a volume shift entered into the box, that will be used instead (including a shift of 0, which will leave the volumes as they are in your MIDI file).
Measures per line
How many measures will be written on each line of the "Music" pane. Each line will start with a measure number. If a note or rest starts in the previous measure and extends into the first measure of a line, it'll be included on the previous line instead.
MIDI channels
MIDI files sometimes contain music on multiple "channels," numbered from 1 to 16. Depending on what produced the MIDI file, different channels might contain different staves or different instruments. mTooth offers three choices:
Melody channel
If you know your melody is contained (or mostly contained) on one MIDI channel, you can enter it into this box to tell mTooth to pick melody notes from that channel when it can.
Look for triplets
Normally, mTooth will look for notes that might be triplets (3:2-length notes). If your MIDI file came from something like Melody Assistant, triplets should be easy to tell from other notes, and it won't be a problem. If you played the MIDI file by hand, the note lengths might not be exactly right, and mTooth may find triplets where they're not supposed to be. To tell mTooth that your music doesn't have any triplets, so it matches every note to the nearest 16th-note length, clear this checkbox.
Use /b# for /+c
Clan Lord allows three octaves, in the key of C. So, the highest note normally available is a B in the highest of the three octaves, /b. Certain instruments also allow one note beyond that, as long as you call it /b# instead of /+c. To tell mTooth not to use /b#, clear this checkbox.
Include lyrics, etc.
MIDI files can include lots of text for the lyrics, song title, copyright, instrument names, and so on. mTooth adds any text from the MIDI file into the music text as comments. When there's a lot of extra text, though, especially when there are lyrics included separately with each note, that can get very cluttered. To tell mTooth to ignore the text, clear this checkbox.
Never change tempo
Normally, mTooth will automatically adjust the tempo notation and note lengths when it needs to, keeping the real note durations very nearly the same. If your music contains notes that are too long (more than 9 sixteenth notes long, which is a half note tied to a sixteenth note), mTooth will slow the tempo and shorten the note, if it can do that evenly without changing the real duration. Similarly, if your tempo is slower than 60 bpm or faster than 180 bpm, mTooth will try to adjust both the tempo and the note lengths to keep the tempo in the allowed range. Clearing this checkbox will disable both those. mTooth will also adjust the tempo to allow triplets. This checkbox does not affect that. Use the "Look for triplets" option instead.

5. Tips

mTooth and Clan Lord

mTooth and Melody Assistant

mTooth was mainly tested with MIDI files produced by Melody Assistant. A few simple things can help Melody Assistant produce correct MIDI files that mTooth can interpret.

MIDI Import


Finally, if you're converting a MIDI 1 file, here's what you can expect.

6. Files

By default, mTooth saves its own files, holding what's in the Music tab plus information about the MIDI file and options. In a pinch, you can read mTooth files in a text editor. You can also export to a "Text File With CL Formats" file, which produces a plain text file with the music in regular, Clan Lord macro, and Clan Lord sheet-music notation.

mTooth reads MIDI 0 files pretty well, and MIDI 1 files partially. MIDI file names usually end in .mid or .midi. If you change your MIDI file in another program, you can re-convert it by clicking the "Apply" button. You shouldn't need to close and re-open it in mTooth. If you have an mTooth file that was originally imported from MIDI, you can continue to work with the MIDI information as long as the MIDI file hasn't moved. If mTooth can't find the original MIDI file anymore, you can still edit your music, but you won't be able to re-convert it.

Sometimes the OS saves stale file information, so if your MIDI-file changes aren't taking effect in mTooth, close the file and reopen it.

7. Known Problems

8. Version History

v1.1.3 - June 30, 2005 v1.1b - June 14, 2005 v1.0b - June 3, 2005 v0.5b - May 17, 2004 v0.4b - April 7, 2004 v0.3b - March 2, 2004 - First public beta release

9. Contact and Credits

mTooth was written by the human who plays Baraboo in the Clan Lord game. You can reach me at BarabooCL, as long as you send the email to comcast dot net. (/curse spammers)
mTooth is © 2004-2005 "Baraboo".

Thanks to