Format:Impulse Tracker module (IT)
| Magic | IMPM at 0 |
|---|---|
| Extensions | .it |
| Endianness | little |
| On this wiki | Facts · Code · Notes · Topics |
Impulse Tracker module (.it, Jeffrey Lim, DOS): little-endian, magic "IMPM" at 0, a 192-byte header, then 32-bit file offsets to instruments ("IMPI"), samples ("IMPS") and packed patterns; samples may be IT-compressed (flag 0x08 in the sample flags) and instruments have NNA, envelopes and a note-sample map.
Overview
IT is the successor of Format:Scream Tracker 3 module (S3M) in the DOS demoscene and in many games (64 channels, new note actions, filters, sample compression, 16-bit and stereo samples). OpenMPT and Schism Tracker write it today.
Identification
"IMPM" at offset 0 (libxmp it_test, lines 46-52). Instrument records start with "IMPI" and sample records with "IMPS". The CWT field (created with tracker) and CMWT field (compatible with) at 0x28 and 0x2A identify the writer: 0x02xx = Impulse Tracker, 0x0214/0x0216/0x0217 are IT 2.14-2.17, special values mark Schism, OpenMPT and others (libxmp identify_tracker, lines 349-440).
Layout
See Fact:Impulse Tracker module (IT)/struct/IT file header. After the 192-byte header: order list (ordnum bytes, 254 = separator, 255 = end), then insnum, smpnum and patnum 32-bit offsets, then optionally an edit history (flag in special) and MIDI configuration (libxmp lines 1262-1295).
Samples
See Fact:Impulse Tracker module (IT)/struct/IT sample header. Compressed samples (flag 0x08) use the IT214/IT215 delta/bit-width coding; the convert bit 0x04 selects the IT 2.15 variant (libxmp it_load.c lines 757-790, 942-975).
Patterns
See Fact:Impulse Tracker module (IT)/behavior/Packed pattern rows.
Pitfalls
- A file with the flag bit 0x04 (use instruments) clear is in sample mode: the instrument count is replaced by the sample count and no IMPI records are read (libxmp lines 349, 1214-1216, 1295).
- Instrument records exist in two layouts: cmwt >= 0x200 uses the new instrument record, older files the old one (libxmp chooses at lines 1315-1330). Unverified: the byte sizes of the two records are not confirmed from the source read.
Code & repositories
libxmp (MIT) src/loaders/it_load.c and it.h; OpenMPT soundlib/Load_it.cpp (Unverified: not read).
- https://github.com/libxmp/libxmp @
5d4f6aa2c7dcdf8e9cd8129fe579d45b36a302da· license: MIT (declared by the contributor; GitHub's detector did not recognize a license file)
Extended Module Player library: loaders for MOD, Soundtracker, S3M, XM, IT and dozens of other tracker formats (src/loaders), with tracker detection heuristics.
Tested on: source read, not run: read only, source files at the pinned commit · checked 2026-10-19; last activity 2026-10-10