NitroTracker v0.1 offline documentation

Overview

Foreword
"Installation"
How to load and play a song (free tour included)
How to load samples and compose a basic track
1. Loading samples
2. Composing something
Reference card
Resources
1. Samples and example music
2. Further reading

NitroTracker is still beta software. Therefore, bugs exist. As long as I have been playing with it now, it has behaved rather nicely. It has neither destroyed my CF card nor my DS. Anyway, if this happens to you, I won't take responsibility, i.e. you try NitroTracker at your own risk!

About bugs

If you find a bug, please remeber what you did before the bug occured. Perhaps even try to reproduce it. Then, send an e-Mail to: me (at) <thisdomain>. Plase include all information you can provide on the bug, if necessary including the song/sample that causes it.

Known issues

Several problems that I know of are not fixed up till now. An important rule you should consider when composing is:

Save early, save often!

Also:

Make sure your CF/SD card is 100% consistent!

Use scandisk or fsck for this.

The worst known issues are:

When you try to load a song that does not fit into RAM (about 3.4 MB are free), it crashes.
Loading/recording too many samples and overloading the RAM causes crashes.

Requirements

A DS that can run homebrew
Any of the following adapters:
- GBA Movie Player CF
- SuperCard CF
- M3 CF
- Neoflash MK2/MK

"Installation"

Just copy NitroTracker.nds and some XMs and/or WAVs to your CF/SD-Card. Get them for example at The MOD Archive.

How to load and play a song (free tour included)

When you first see the user interface, you might think "What the schnitzel? This looks really complicated!" But don't worry: There are not really that many controls and you can learn how to handle them quite fast. But let's first start off really simple by just loading a song.

Tap on the icon that shows three pancakes that are poked with a stick (actually I intended to draw a hard drive). This will open the file dialog.

Now navigate to the folder where you stored your XMs (or just scroll down if they are in the top folder) and tap on a file.

To load it, click the "load" button and wait for a second.

You should now see some strange numbers appearing on the top screen. You can use the d-pad to scroll. You should also see that the list on the right becomes filled. This list shows the instrument names. But alomost no XM composer uses it for that purpose any more. Instead, they put additional song info into the instrument names. Wanna see how the instruments look? Then tap on the icon next to the pancakes that looks like a sound wave.

What you see now is the sample that belongs to the instrument selected in the list on the right. You can select other instruments in the list and play them by using the keyboard. You can see some more song information by going back to the first screen (click the note icon).

The list with the strange numbers on the left is the so-called pattern order table. It defines the order in which the different parts of the song (called patterns) shall be played. On the right, the number of channels is displayed. This number may be higher than 16, but only the first 16 channels are actually played. Below the pattern order table, there are two numbers that have to do with the speed of the song: Tempo and BPM. Increasing the BPM makes the song play faster, as you might expect. But when you increase the tempo setting, the song speed decreases. Don't ask me who invented this. You can think of tempo as the coarse speed setting and the BPM as finetuning. Below the speed controls, you see the name of the song. Don't like it? Then push the "..." next to it and change it.

Did I forget something? Well, the "play" button plays the song :-)

How to load samples and compose a basic track

Loading samples

A word of warning: I may write mobile trackers in my spare time, but I'm rather musically illiterate, at least when it comes to producing music. So, this is not meant to be composing class, this is meant to explain how to track with NitroTracker.

Warning (2): Make sure that the filesystem of the CF/SD is consistent by checking with scandisk/fsck! Sometimes, when NDS apps write to the card, the filesystem gets corrupted although you won't realize. When saving to a corrupt filesystem you may loose your work!

First of all, we need samples. We all like retro sound, so we use this nice LSDJ sample pack from the freesound project kindly provided by starpause. Download the pack and unzip it to a new folder on your CF/SD card. Then put it into your DS and start NitroTracker.

To load some samples, click on the hard disk icon.

Then select "smp". This will cause that only samples are displayed in the browser.

Now go to the folder where the sample pack lies. When you load a sample, it is loaded into the currently selected intrument bank, i.e. the highlighted item in the list on the right. Make sure, the first item is selcted, then tap on the file starting with "3044" and tap "load".

Now select the second sample bank and the sample starting with "3049" and tap "load" again.

You can play around on the keyboard to listen to the samples. Since their names are not very descriptive, you might want to rename them.

To do this, press the "ren" button under the instrument list and enter the new name with the typewriter that appears. (I use the old-fashioned term typewriter to differentiate the (computer) keyboard from the (musical) keyboard.)

Composing something

Now we come to the fun part. To record a song, press the "record" button that is under the "ren" button. This button toggles record mode. Now, when you press a key on the keyboard, an entry is added to the pattern (the strange table on the top screen that we've been ignoring so far). Just try it out. Something like this will occur:

Here, blue stands for the note, orange for the instrument and green for the volume. The first blue character is the note itself, in this case an "H". The blue "4" is the octave of the note. You can chance the base octave using the "oct" numberbox. The orange "2" means that we have used instrument nr. 2 and the green "FF" is a hex value that means that this note is played at maximum volume, which is standard.

The pattern is played from top to bottom. I.e. when you press "play", it scrolls down and plays the notes, row after row. By push the d-pad left or right, you can switch channels. Two notes that are in the same row on different channels are played at the same time. To get some practice, try to track the following:

The first channel is a drum pattern and the second channel is a stupid melody, known as the swedish car symphony (it's not very famous). When you make a mistake, you can just scroll up with the d-pad and correct it. To clear a note, press the "clr" key right of the keyboard. Bolding the B button with accelerate scrolling.

You can also press the "flp" button on the top right of the screen and make selections in the pattern by dragging the stylus. The "cpy" button copies the selected area to the clipboard. The "pst" button pastes it with the upper right corner at the current cursor position.

When you're ready, press the play button the listen to this annoyying song. You will realize that the pattern goes on even after the melody is finished.

To change this, tap the note icon. This will bring you to the song view. There is a numberslider named "ptn len". It's used by putting the stylus down anywhere on it and then sliding it up or down. In our case, we slide it down until the number reaches 20. When you scroll down in the pattern using the d-pad, you will see that the pattern now ends at the same time as the song.

Now we want our patterns to be looped three times to make the song even more annoyying. For this, we edit the pattern order table (the table on the left). It currently has one entry that sais "0 0". This means that pattern 0 is played at position 0. You can change the pattern by using the "<" and ">" buttons right to it. Pushing ">" will automatically create a new empty pattern of the same size as the current one. but since we only want one pattern, change it back to 0.

Press the "ins" button twice to insert the current pattern into the pattern order table two more times. If you press play now, the pattern will be played three times and you will notice how the highlighted item in the pattern order table changes automatically.

Think that your song is too slow or too fast? Change the speed with the "tmp" and "bpm" number boxes.

Currently the name of our song is "unnamed", as you can read below the tempo settings. To change it to something more suitable, press the "..." button right of the name.

There we go :-) Now to save the song, press the "three pancakes" icon.

In the file dialog, select "sng" again, then navigate to the folder where you want to save it. To enter a name, press "..." right of the empty name field. You don't have to enter ".xm" in the end, because it is appended automatically. Now press "save". When the window disappears, it's safe to turn off your DS.

You can now copy the file to your computer and play it with Winamp, XMMS or whatever you like. You can also edit it with a PC tracker like Milkytracker.

Well, this concludes my introduction to bad tracking. Have fun and send me your results!

Reference card

Tabs

The song tab

Opens song controls, where you can change several song parameters.

The disk tab

Opens the file browser there you can load and save samles and songs.

The sample tab

Here you can view samples and record your own.

Song controls

	"ins" inserts the current pattern into the pattern order table at the current position. "del" deletes the highlighted pattern. "<" chooses the previous pattern ">" chooses the next pattern
	"sub" deletes the last channel (in all patterns) "add" adds a new channel after the last (in all patterns)
	Changes the length of the current pattern (Usage: Put your pen down anywhere on the numberslider and slide the pen up or down)
	"tmp" defines the tempo (coarse speed) lower = faster "bmp" defines the bpm (fine speed) lower = slower
	"..." shows a typewriter for changing the name of the song
	Shows a dialog box for zapping the patterns, the instruments or the entire song.

Recording controls

	Toggles record mode
	"ren" shows a typewriter for renaming the currently selected instrument
	Defines how many rows to scroll forward in the pattern when a note is entered.
	Defines the base octave of the keyboard, i.e. if the value is 4, the leftmost key on the keyboard plays a C-4.
	"del" deletes the note under the cursor, moving all all notes below it up one row "clr" deletes the note under the cursor "--" enters a stopnote, i.e. a silent note that stops the previously toggled note
	This, ladies and gentlemen, is called a "keyboard".
	D'uh!
	Flips the screens.
	"cut" copies the selected rectangle to the cipboard and clears it "cpy" copies the selected rectangle to the cipboard "pst" pastes the contents of the clipboard with the upper left corner at the cursor position

Buttons

D-Pad	scrolls in the pattern
B	Accelerates vertical scrolling
Start	Plays the song, starting at the current pattern
Select	Stops the playing song or sample
X	Flips the screens
Lid	Yes, the lid is a button :-) Closing enters standby mode Opening leaves standby mode

Resources

Samples and example music

Good resources for samples and XM files are: