SCHISMTRACKER(1)

📦
this version · 5 versions
, in debian trixie, fedora 43, fedora 44, nixos 26.05, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 SCHISMTRACKER 💖

okay so bestie, welcome to the schismtracker manual page, from the General Commands Manual section — yes it's a whole tracked music editor, and it's literally based on Impulse Tracker, and I am obsessed. grab a snack, we're doing this. 🎀

✨ NAME ✨

schismtracker — tracked music editor based on Impulse Tracker 🎵

✨ SYNOPSIS ✨

schismtracker [options] [directory] [file]

✨ DESCRIPTION ✨

schismtracker is a tracked music module editor, and its whole thing is trying to match the look and feel of Impulse Tracker as closely as it possibly can. like, no cap. 🫶

It can load most common tracker formats, it supports saving as IT and S3M, and it can also export to WAV and AIFF. it's giving versatile. it's giving iconic. 💅

✨ OPTIONS ✨

  • -a, --audio-driver=DRIVER[:DEVICE] — audio device config, bestie. DRIVER is the SDL driver you wanna use, like alsa (ALSA), dma or dsp (OSS); DEVICE is the name of the actual device itself, for example hw:2 or /dev/dsp1. 🔊
  • -v, --video-driver=DRIVER — the SDL video driver, like x11, dga, or fbcon. heads up though: this is different from the video driver setting inside the program, and it's unlikely to be useful. 🙈
  • --network, --no-network — turn networking on or off (it's on by default). used for MIDI over IP. 🌐
  • --classic, --no-classic — start Schism Tracker in "classic" mode, or don't. this is mostly cosmetic ngl, although it does change the program's behavior slightly in a few places. 👑
  • -f, -F, --fullscreen, --no-fullscreen — enable/disable fullscreen mode at startup. 🖥️
  • -p, -P, --play, --no-play — start playing after loading the song from the command line. ▶️
  • --diskwrite=FILENAME — render output to a file, and then exit. the WAV or AIFF writer gets auto-selected based on the file extension. include %c somewhere in the name to write each channel separately. this is meaningless if no initial filename is given, fr. 💾
  • --headless — run in non-interactive mode for automated rendering. requires both --diskwrite and an input song file to be specified. useful for batch conversion of songs to audio files. 🤖
  • --font-editor, --no-font-editor — run the font editor (itf). you can also get here by pressing Shift-F12. 🔤
  • --hooks, --no-hooks — run hooks. enabled by default. 🪝
  • --version — display version information and build date. 📅
  • -h, --help — print a summary of available options. 🆘

A filename supplied on the command line will be loaded at startup. additionally, if either a file or directory name is given, the default module, sample, and instrument paths will be set accordingly. ✨

✨ USAGE ✨

A detailed discussion of how to use Schism Tracker is far beyond the scope of this document, but here's a very brief rundown of the basics. context-sensitive help can be accessed at any time while running the program by pressing F1. 💖

The F3 key brings you to the sample list. press enter here to open a file browser, navigate in the list using the up/down arrow keys, and hit enter again to load a sample. you will likely want to get some samples to work with. you can also "rip" from existing modules; see for example http://www.modarchive.org/ for a very large selection of modules. (keep in mind, however, that some authors don't appreciate having their samples ripped!) 😭

Now that you've loaded a sample, press F2 to get to the pattern editor. this is where the majority of the composition takes place. in short, the song is laid out vertically, with each row representing 1/16 note; to play multiple notes simultaneously, they are placed in different channels. the four sub-columns of each channel are the note, sample number, volume, and effect. a list of effects is available in the pattern editor help, but you can safely ignore that column for now. assuming a US keymap, notes are entered with the keyboard as follows:

           (Note)        C# D#    F# G# A#    C# D#    F# G# A#    C# D#
                      | | || | | | || || | | | || | | | || || | | | || | |
                      | | || | | | || || | | | || | | | || || | | | || | |
           (What you  | |S||D| | |G||H||J| | |2||3| | |5||6||7| | |9||0| |
            type)     | '-''-' | '-''-''-' | '-''-' | '-''-''-' | '-''-' |
                      | Z| X| C| V| B| N| M| Q| W| E| R| T| Y| U| I| O| P|
                      '--'--'--'--'--'--'--'--'--'--'--'--'--'--'--'--'--'
           (Note)       C  D  E  F  G  A  B  C  D  E  F  G  A  B  C  D  E
                       (Octave 0)           (Octave 1)           (Octave 2)

The / and * keys on the numeric keypad change octaves, and the current octave is displayed near the top of the screen. try typing qwerty into the pattern — it will enter an ascending note sequence, and you'll hear the notes as they're entered. (of course, assuming you loaded a sample!) press F6 to play your pattern, and F8 to stop. 🎹

Other important keys for the pattern editor include Ins/Del to shift notes up and down within a channel, Shift-Arrows to mark a block, Alt-C/Alt-P to copy and paste, and Alt-U to clear the mark. there are well over a hundred key bindings for the pattern editor; it is well worth the effort to learn them all eventually. 💅

Now that you have something in your pattern, you'll need to set up an orderlist. press F11 to switch to the orderlist page, and type 0 to add the pattern you created. now press F5 to start playing. the song will begin at the first order, look up the pattern number and play that pattern, then advance to the next order, and so forth. 🔥

Of course, having only one pattern isn't all that interesting, so go back to the pattern editor and press the + key to change to the next pattern. now you can write another four bars of music and add the new pattern to the orderlist, and the next time you play the song, your two patterns will play in sequence. 🌈

You may wish to give your song a title; press F12 and type a name in the box at the top. you can also adjust the tempo and a number of other settings on this page, but for now, most of them are fine at their default values. 🎀

To save your new song, press F10, type a filename, and hit enter. you can load it again later by pressing F9. 💾

This tutorial has deliberately omitted the instrument editor (on F4), for the purposes of brevity and simplicity. you may want to experiment with it once you have a feel for how the program works. (select "instruments" on F12 to enable instrument mode.) 🧚

✨ HISTORY ✨

Storlek began studying Impulse Tracker's design in 2002, noting subtle details of the design and implementation. posts on the Modplug forums about rewriting Impulse Tracker were met with ridicule and mockery. "It can't be done," they said. 💀

Schism Tracker v0.031a was released in July 2003, though very little worked at that point, and it was more of a player with primitive editing capabilities. file saving was hard-coded to write to "test.it" in the current directory, and there was no way to load a sample. 😭

The first version that was more or less usable was 0.15a, from December 2004.

From 2005 through 2009, Mrs. Brisby did most of the development, and implemented tons of features, including MIDI support, mouse support, and disk writing. 👑

Storlek "took over" development again in 2009, and incrementally rewrote much of the code through 2015.

In 2016, Schism Tracker was moved to GitHub under shared maintainership. since then, many people have contributed improvements and bug fixes to the codebase. 🫶

✨ FILES ✨

  • ~/.schism/config — program settings, stored in an INI-style format. most options are accessible from within Schism Tracker's interface, but there are a few "hidden" options. 🙈
  • ~/.schism/startup-hook, ~/.schism/exit-hook, ~/.schism/diskwriter-hook — optional files to execute upon certain events. (Must be executable) 🪝
  • ~/.schism/fonts/ — font.cfg, and any .itf files found in this directory, are displayed in the file browser of the font editor. 🔤

🌸 Supported file formats 🌸

  • MOD — Amiga modules (with some obscure variants such as FLT8)
  • 669 — Composer 669 / Unis669
  • MTM — MultiTracker
  • S3M — Scream Tracker 3 (including Adlib support)
  • XM — Fast Tracker 2
  • IT — Impulse Tracker (including old instrument format)
  • MDL — Digitrakker 3
  • IMF — Imago Orpheus
  • OKT — Amiga Oktalyzer
  • SFX — Sound FX
  • MUS — Doom engine (percussion missing)
  • FAR — Farandole Composer
  • STM — Scream Tracker 2 (partial functionality)
  • ULT — UltraTracker (partial functionality)
  • S3I — Scream Tracker 3 sample
  • WAV — Microsoft WAV audio
  • FLAC — Xiph.Org Free Lossless Audio Codec audio
  • AIFF — Audio IFF (Apple)
  • 8SVX — Amiga 8SVX sample
  • ITS — Impulse Tracker sample
  • AU — Sun/NeXT Audio
  • RAW — Headerless sample data
  • PAT — Gravis UltraSound patch
  • XI — Fast Tracker 2 instrument
  • ITI — Impulse Tracker instrument

Schism Tracker is able to save modules in IT and S3M format, sample data as ITS, S3I, AIFF, AU, WAV, and RAW, and instruments as ITI. additionally, it can render to WAV and AIFF (optionally writing each channel to a separate file), and can export MID files. 💾✨

✨ AUTHORS ✨

Schism Tracker was written by Storlek and Mrs. Brisby, with player code from Modplug by Olivier Lapicque. based on Impulse Tracker by Jeffrey Lim. 🫶

Additional code and data have been contributed by many others; refer to the file AUTHORS in the source distribution for a more complete list. 📜

The keyboard diagram in this manual page was adapted from the one used in the documentation for Impulse Tracker, which in turn borrowed it from Scream Tracker 3. ⌨️

Copyright © 2003-2025 Storlek, Mrs. Brisby et al. Licensed under the GNU GPL <http://gnu.org/licenses/gpl.html>. this is free software: you are free to change and redistribute it. there is NO WARRANTY, to the extent permitted by law. ⚖️

✨ BUGS ✨

They almost certainly exist. 😭 post on https://github.com/schismtracker/schismtracker/issues if you find one. Agitha shares her happiness with benefactors of the insect kingdom. 🦋🐛

✨ INTERNETS ✨

✨ SEE ALSO ✨

chibitracker(1), milkytracker(1), protracker(1), renoise(1), ocp(1), xmp(1) 💖

okay that's the whole page, bestie, and that's the tea ☕ — this was SCHISMTRACKER(1) from the General Commands Manual, dated Jan 2, 2025. now go make some music, you absolute icon. 🎀👑💅✨

📦 where this page comes from