BambooTracker is a music tracker for the Yamaha YM2608 (OPNA) sound chip which was used in NEC PC-8801/9801 series computers.
- Development builds: get "artifacts" from Appveyor
- See below chapters "Build on Linux" - "Install package on Debian or Ubuntu".
The files created by this tracker are called "modules". One such module contains songs (song data), instruments (tone data) and settings common to each song. In a song, the channel of each sound source is assigned to a track, and the track holds multiple patterns (performance patterns). The patterns are played by registering them in the order they appear the song. (from beginning to end) A pattern describes a structure in which steps are arranged in chronological order. Key On / off and most effects are described in step units. A tick is the minimum performance unit, one step = n ticks. The effects (such as vibrato) which change with the count unit are based on ticks.
In the Instrument List, you control the instruments (tone data) used in the module. All songs in the module share the instruments registered here. Up to 128 instruments can be registered (
Double-clicking an instrument opens the Instrument Editor and allows you to edit said instrument. Instruments can share their settings (properties) with other instruments. For instruments that share properties, a list of all users (instruments) of each property are displayed.
Some instrument editors can set performance sequences. One column corresponds to one tick in the sequence editor. It also corresponds to specifying the sequence loop / release point. Left click to create point or increase count / type change, right click to delete point or decrease count. You can move the position by dragging the edge of the point. For the release type, you can select from the following three types only for envelope setting of SSG.
- Fix: Run at specified volume from release point at Key Off
- Absolute: Run from the first point after the release point to reach the volume at Key Off
- Relative: Execute from the release point with the volume set as the maximum volume at Key Off
In the FM Editor, you can configure the
- Operator Sequence
of an FM instrument.
It enables to paste plain text of envelope like MML. You can add and fix text formats in configuration. There are 8 default formats: FMP, FMP7, MMLDRV, MUCOM88, MXDRV, NRTDRV(
VOICE_MODE=0), PMD, VOPM.
Note the tracker reads digits from text in the order of appearance. Please remove needless digits contained in tone name or comments upon using default format.
In the SSG Editor, you can configure the
- Tone / noise
of an SSG instrument. The software envelope will be invalid while using waveforms other than rectangular waves.
In the Order List, we will register the pattern numbers in the order in which they will be played. The rows correspond to the order, and the columns correspond to tracks.
The maximum length of the list is 256 (
In the pattern Editor, events such as Key On are registered in chronological order. One line represents one step. The columns of each track, from left to right, are:
- Instrument numbers
- Two characters before effect 1
- Two characters after effect 1
- Two characters before effect 2
- Two characters after effect 2
- Two characters before effect 3
- Two characters after effect 3
- Two characters before effect 4
- Two characters after effect 4
Effects 2-3 can be displayed and hidden by pressing the + and - buttons on the header.
Up to 256 patterns (
$FF) can be created for each track.
In the Settings Field you can adjust the module's metadata and performance settings of the song.
Specify the tempo of the song. The tempo here is different from bpm, it is simply an indicator of speed.
It can also be specified with the
Set the number of ticks for rough estimate in 1 step. Tempo may cause this value to change at run time.
It can also be specified with the
Sets the number of steps in the default pattern. The minimum value is 1, the maximum value is 256.
Specify the groove number set in the Groove Editor. When using groove, all other performance speed settings are fixed.
It can also be specified with
|Ctrl+N||Create new module|
|Ctrl+P||Open module property dialog|
|Ctrl+I||Open current instrument editor|
|F1||Show effect list dialog|
|F5||Play from start|
|F7||Play from current position|
|Space||Toggle jam/edit mode|
|Alt+L||Focus on instrument list|
|Alt+O||Focus on order list|
|Alt+P||Focus on pattern editor|
|Ctrl+I||Open current instrument editor|
|Home||Jump to first order|
|End||Jump to last order|
|PageUp||Jump to upper oder|
|PageDown||Jump to lower oder|
|Insert||Insert order below|
|Ctrl+M||Paste and mix|
|Tab||Jump to right track|
|BackTab||Jump to left track|
|Home||Jump to first step|
|End||Jump to last step|
|PageUp||Jump to upper step|
|PageDown||Jump to lower step|
|Ctrl+Up||Jump to upper 1st highlighted step|
|Ctrl+Down||Jump to lower 1st highlighted step|
|BackSpace||Delete the step above|
|* (numpad)||Increase octave/echo buffer number|
|/ (numpad)||Decrease octave/echo buffer number|
|^||Echo buffer access|
There are two rows of a piano keyboard:
Current octave+1 2 3 5 6 7 9 Q W ER T Y UI O Current octave S D G H J L Z X CV B N M, .
It is able to reverse the order of FM volume (Configuration -> General -> Reverse FM volume order).
|00xy||Arpeggio (x[0-f]: 2nd note, y[0-f]: 3rd note)||Arpeggio||-|
|01xx||Portamento up (xx[00-ff]: depth)||Portamento up||-|
|02xx||Portamento down (xx[00-ff]: depth)||Portamento down||-|
|03xx||Tone portamento (xx[00-ff]: depth)||Tone portamento||-|
|04xy||Vibrato (x[0-f]: period, y[0-f]: depth)||Vibrato||-|
|07xy||Tremolo (x[0-f]: period, y[0-f]: depth)||Tremolo||-|
|08xx||Pan (xx: 00=No sound, 01=Right, 02=Left, 03=Center)||-||Pan|
|0A0x||Volume slide down (x[0-f]: depth)||Volume slide down||-|
|0Ax0||Volume slide up (x[0-f]: depth)||Volume slide up||-|
|0Bxx||Position jump (xx: order)||Position jump||Position jump|
|0Cxx||Song end (xx: any number)||Song end||Song end|
|0Dxx||Pattern break (xx: start step on the next order)||Pattern break||Pattern break|
|0Fxx||Speed/tempo change (xx[00-1f]: speed, [20-ff]: tempo)||Speed/tempo change||Speed/tempo change|
|0Gxx||Note delay (xx[00-ff]: count)||Note delay||Note delay|
|0Oxx||Groove (xx[00-ff]: number)||Groove||Groove|
|0Pxx||Detune (xx[00-ff]: pitch (xx-80))||Detune||-|
|0Qxy||Note slide up (x[0-f]: count, y[0-f]: seminote)||Note slide up||-|
|0Rxy||Note slide down (x[0-f]: count, y[0-f]: seminote)||Note slide down||-|
|0Sxx||Note cut (xx[01-ff]: count)||Note cut||Note cut|
|0Txy||Transpose delay (x[1-7]: upwards count, [9-f]: downwards count (x-8), y[0-f]: seminote)||Transpose delay||-|
|0Vxx||-||-||Master volume (xx[00-3f]: volume)|
|Mxyy||Volume delay (x[1-f]: count, yy[00-ff]: volume)||Volume delay||Volume delay|
The tracker enables to open and save to .btm (BambooTracker module file).
The tracker can load instrument from the following files.
- .bti (BambooTracker instrument file)
- .dmp (DefleMask preset file)
- .tfi (TFM Music Maker instrument file)
- .vgi (VGM Music Maker instrument file)
- .opni (WOPN instrument file)
- .wopn (WOPN bank file)
- .y12 (Gens KMod dump file)
- .ins (MVSTracker instrument file)
It also supports loading plain text of FM envelope.
A instrument save as .bti file.
The tracker can export a song to the following files.
- .wav (WAVE file)
- .vgm (VGM file)
- .s98 (S98 file)
BambooTracker supports following languages:
- English (default)
Build on Linux
On Ubuntu 18.04:
Qt5 (including qmake)
Qt5 Multimedia plugins
sudo apt-get install \ build-essential \ qt5-default qtmultimedia5-dev libqt5multimedia5-plugins
cd BambooTracker qmake make
Install package or build on FreeBSD
To build the BambooTracker via FreeBSD ports
cd /usr/ports/audio/bambootracker make install clean
To install the package
pkg install bambootracker
Install package on Debian or Ubuntu
apt-get install bambootracker
This program and its source code are licensed under the GNU General License Version 2.
I would like to thank the following people for making it:
- Qt team for Qt framework
- MAME team, and Valley Bell for the codes of YM2608 chip emuration
- Mark James for the tool bar icons
- VGMRips team for the VGM file format documentation
- Some tracker creators, especially HertzDevil of 0CC-FamiTracker, Leonardo Demartino (delek) of Deflemask Tracker and Lasse Öörni (Cadaver) of GoatTracker for UI and routines of the tracker
- Decidetto for the application icon
- Vitaly Novichkov (Wohlstand) for WOPN instrument format files
- maak, SuperJet Spade and Dippy for sample modules
- Ru^3 for S98 file format documentation
- SCCI team for SCCI libraries
- Gary P. Scavone and others for RtMidi libraries
- Thanks Alexey Khokholov (Nuke.YKT) and Jean Pierre Cimalando for Nuked OPN-Mod emulation
- Artyom Beilis for nowide library
- Jean Pierre Cimalando and Olivier Humbert for French translation
- And everyone who helps this project!