1
1
# Chiptracker
2
2
3
- Chip tracker for the bitbox, based on [ lft's HArdware Chiptune] ( http://www.linusakesson.net/hardware/chiptune.php )
3
+ Chip tracker for the bitbox, based on [ lft's Hardware Chiptune] ( http://www.linusakesson.net/hardware/chiptune.php )
4
4
5
5
![ screenshot] ( chiptracker.png )
6
6
7
- ## Major changes
7
+ ## Updated documentation (things that changed from lft's original tracker)
8
8
9
- Squashed PLAY/EDIT/IDLE modes down into one, because it felt difficult to
10
- move around nimbly.
9
+ Start the tracker by loading the binary from the bitbox bootloader, or use the
10
+ emulator version.
11
11
12
- TODO: Add some extra info in song column, to show Track and Transposition columns.
12
+ * Press Ctrl+O to list and load files (from SD card or current directory in emu).
13
+ * Press Ctrl+F to change the file name, then Ctrl+W to save.
14
+ * Press space to play/pause, enter to toggle edit mode
15
+ * In the emulator, press escape to exit. On real hardware, use the reset button.
13
16
17
+ Don't worry, there are on-screen hints to all this.
14
18
15
- ## Original Documentation
19
+ ## Original Documentation (with out of date information removed)
16
20
17
21
Hi!
18
22
19
- This is the tracker I used in the hardware chiptune project
20
- (http://www.linusakesson.net/hardware/chiptune.php ). It was never intended to
23
+ This is the tracker I used in the
24
+ [ hardware chiptune project] ( http://www.linusakesson.net/hardware/chiptune.php ) .
25
+ It was never intended to
21
26
be used by anyone other than me, so it's not exactly user friendly.
22
27
23
28
This is a quick documentation attempt.
24
29
25
- You have to give the tracker a file name when you're starting it. So type
26
- "./tracker test2.song" to start working on the existing song, or type e.g.
27
- "./tracker my_song.song" to start from scratch. Although the GUI hints that you
28
- can later press ^F to change the file name, this was never implemented.
29
-
30
30
Once you've started the tracker, you'll see that the screen is divided into
31
31
three sections: song, track and instrument. Use TAB to move between these
32
32
sections. Alternatively, if you're in the song section and the cursor is on a
@@ -41,10 +41,8 @@ Use < and > to change the current octave. The main part of the keyboard is used
41
41
to enter notes. The keyboard layout is adapted for a US qwerty keymap. You can
42
42
edit gui.c to change this to fit a Dvorak keymap instead.
43
43
44
- Press ^E (control-E) to exit without saving. Press ^W ("write") to save. Press
45
- \# to optimize the song (remove unused tracks, move tracks together) and % to
46
- export the song into a packed format. (% will always export to two files called
47
- "exported.s" and "exported.h" in the current working directory).
44
+ Press ^W ("write") to save. Press
45
+ \# to optimize the song (remove unused tracks, move tracks together).
48
46
49
47
In the song and instrument editors, use capital A, I and D to add, insert and
50
48
delete lines. In the track and instrument editors, use capital C and V for copy
@@ -70,8 +68,7 @@ The available commands are:
70
68
~xy Set vibrato. x = depth, y = rate.
71
69
72
70
Investigate test2.song, and play around, and you'll probably get the hang of
73
- things! Remember that the packed format only supports one command per track
74
- line (see homepage).
71
+ things!
75
72
76
73
Good luck!
77
74
0 commit comments