Manual: Module formats

From OpenMPT Wiki
Jump to: navigation, search

File formats that can be read and written by OpenMPT[edit]

The ProTracker MOD format (.mod)[edit]

The MOD format was the first file format for tracked music on the Commodore Amiga. A very basic version of this format (with only very few pattern commands and short samples supported) was introduced by Karsten Obarski’s Ultimate SoundTracker. It was designed to use 4 channels each with one voice. Ultimate SoundTracker was soon superseded by NoiseTracker and ProTracker, which allowed for more tracker commands (effects), longer samples, more patterns and other improvements. Later, variants of the MOD format that appeared on the Personal Computer extended the number of channels, added panning commands (the Amiga’s four hardware channels had a pre-defined stereo setup) and expanded the Amiga’s frequency limit, allowing for more octaves of notes to be supported.

Arguably one of the most widespread tracker formats (also due to its use in many computer games and demos), it is also one of the simplest to use, but also only provides few pattern commands to use. With OpenMPT, you can use up to 99 tracks (the default is 4, and not all applications support that many channels - few support more than 32). Instruments cannot be used in the MOD format, only 8-bit samples with a maximum size of 128 KB per sample and with a limited set of parameters. Initial tempo, number of rows (always 64), and the “time signature” cannot be defined (always uses the highlight values provided in the Display setup). There is limited sample control and few global settings.

The ScreamTracker 3 format (.s3m)[edit]

Scream Tracker 3′s S3M format added sample tuning (defining the exact frequency of the middle C for samples), increased the number of playback channels, made use of an extra column specifically for volume control (which was extended by other trackers to handle panning commands as well), and compressed pattern data for smaller file sizes. OpenMPT has similar limitations when working with S3M files as MOD, except with the S3M format, you can set the initial tempo and speed (ticks per row), initial global and sample volume, initial channel pan, and set each sample’s playback frequency. Compared to MOD, there is also a different, more expanded set of effect commands.

The FastTracker 2 format (.xm)[edit]

With the XM format, Fasttracker 2 introduced the concept of “instruments”, which applied volume and panning envelopes to samples. It also added the ability to map several samples to the same instrument for multi-sampled instruments or drum sets. XM uses instrument-based panning – instrument numbers in patterns always reset the channel’s panning to the current sample’s initial panning. It uses MOD effect command letters, plus a few of its own for more sound control. You can define initial tempos and speeds; provide envelopes to samples by assigning them to instruments; set sample looping and apply automatic sample vibrato oscillation; and with OpenMPT, apply VST plugins to instruments, channels, or the whole track to spice up your old XM compositions.

The Impulse Tracker format (.it)[edit]

Impulse Tracker introduced the IT format, which, in comparison to the XM format, allows instruments to also specify the transposition of assigned samples depending on the note being played, applying resonant filters to samples, and defining “New Note Actions” (NNAs) for instruments to release playing notes on a pattern channel while a new note is already playing, which helps to keep the number of pattern channels to while still being able to have a high polyphony. Like S3M files (and contrary to XM files), panning is channel-based, meaning that channels have an initial pan position which can be overridden by panning commands or instruments’ and samples’ default panning settings. Samples also have decent compression in file storage when saving IT files directly in Impulse Tracker or enabling OpenMPT's experimental IT compression settings. IT effect commands use a more advanced set of S3M commands.

The OpenMPT format (.mptm)[edit]

MPTM is OpenMPT’s own format. It is based on the IT format, with added capabilities of custom sample tunings, Parameter Control events, multiple Pattern Sequences, tempo swing, fractional tempos, global resampling settings and many more features. Some features such as VST plugins are currently usable in XM and IT as well but really should only be used in MPTM files. You can find these features by using the Find Hacks functionality in the View menu.

The MIDI format (.mid)[edit]

MIDI files are of course not module files, and OpenMPT is by no means a MIDI editor. MIDI files store note data and timing information in a way that is not easily converted to a pattern-based tracker format.

OpenMPT can import many MIDI-sequenced songs in the MID / RMI format, but it is important to remember that sequencer files are not the same as modules and the data within these files does not translate well to a tracking format. MIDI import is thought of as a tool to import your old MIDI-based projects, remix stems and similar things more than as a way to listen to MIDI files in OpenMPT — there are far better MIDI players out there.

When importing MIDI files, experiment with the File Import settings in the MIDI Setup. In particular, try different quantization values if not enough note detail can be imported, or lower the Ticks / Row to get rid of some unnecessary Note Delay and Note Cut effects at the expensive of a less accurate import.

OpenMPT supports the following General MIDI and XG features:

  • MIDI CCs: Bank Select, Pan Position, Expression, Channel Volume, Hold Pedal, CC 111 loop points, Mono / Poly Operation, All Controllers / Sounds / Notes Off
  • RPNs: Pitch Bend Range, Coarse Tune
  • System Exclusive: Master Volume, Master Transpose, GS Drum Kit. XG System On enables drums on bank 127 on any channel.

OpenMPT reads embedded soundfonts in RMI files, and automatically loads patches from soundfonts that carry the same name as the MIDI file, as long as they are placed in the same directory.

File formats that can only be read by OpenMPT[edit]

The following formats can be imported into OpenMPT. Internally, they are converted to one of the file formats described above. Depending on the source format, conversion might not always be accurate.

  • Composer 669 / UNIS 669 (.669)
  • ASYLUM Music Format / Advanced Music Format (.amf)
  • Extreme’s Tracker / Velvet Studio (.ams)
  • Digi Booster Pro (.dbm)
  • Digi Booster (.digi)
  • X-Tracker (.dmf)
  • DSIK (.dsm)
  • Digital Tracker / Digital Home Studio (.dtm)
  • Farandole Composer (.far)
  • General Digital Music (.gdm)
  • Ice Tracker / SoundTracker 2.6 (.ice / .st26)
  • Imago Orpheus (.imf)
  • Impulse Tracker Project (.itp) – legacy OpenMPT format with instruments stored in external files rather than directly in the module
  • Jazz Jackrabbit 2 Music (.j2b)
  • SoundTracker and compatible (.m15 / .stk)
  • DigiTrakker (.mdl)
  • OctaMED (.med)
  • MadTracker 2 (.mt2)
  • MultiTracker (.mtm)
  • Oktalyzer (.okt)
  • Epic Megagames MASI (.psm)
  • Disorder Tracker 2 (.plm)
  • ProTracker 3.6 IFF (.pt36)
  • PolyTracker (.ptm)
  • SoundFX / MultiMedia Sound (.sfx / .sfx2 / .mms)
  • Scream Tracker 2 (.stm)
  • Soundtracker Pro II (.stp)
  • UltraTracker (.ult)
  • Unreal Music (.umx) only from Unreal (Tournament 1), Deus Ex and Jazz Jackrabbit 3D
  • Grave Composer (.wow)

Compressed modules[edit]

OpenMPT also handles several compression formats, so you do not need to extract modules from these formats to be able to listen to them: Modules in ZIP, RAR, LHA and GZ containers can be opened directly. Modules in ZIP or RAR archives make use of custom file extensions sometimes; Instead of ZIP or RAR, the file extension might be one of the following: MDZ, S3Z, XMZ, ITZ, MPTMZ, MDR. OpenMPT generally does not care about file extensions though, so it does not matter which extension you use for your compressed modules.

OpenMPT cannot save modules into compressed files, you will have to save your work as a normal module first and then compress it e.g. with Windows’ zip capabilities or other third party compression utilities.

Some module-specific compression routines are also supported, for example MMCMP, XPK and PowerPacker PP20.

Furthermore, OpenMPT can handle MO3 files. MO3 is a highly compressed module format with lossy sample compression. MO3 encapsulates the features of several module formats (IT, MOD, MPTM, MTM, S3M, XM), but with one big difference: MP3 and Ogg compressed samples. It also has a lossless codec for any samples that do not like lossy encoding, and the whole file structure is compressed too.