Skip to content
YM2608 (OPNA) music tracker 🎍
Branch: master
Clone or download

README.md

icon BambooTracker

GitHub release Platform: windows | linux Travis CI Build Status Appveyor Build status LICENSE

Example

BambooTracker is a music tracker for the Yamaha YM2608 (OPNA) sound chip which was used in NEC PC-8801/9801 series computers.

日本語

Downloads

On Windows:

On Linux:

  • See below chapters "Build on Linux" - "Install package on Debian or Ubuntu".

Glossary

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.

Interface Overview

Instrument List

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 ($00 - $7F).

Instrument Editor

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

FM Editor

In the FM Editor, you can configure the

  1. Envelope
  2. LFO
  3. Operator Sequence
  4. Arpeggio
  5. Pitch

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.

SSG Editor

In the SSG Editor, you can configure the

  1. Waveform
  2. Tone / noise
  3. Envelope
  4. Arpeggio
  5. Pitch

of an SSG instrument. The software envelope will be invalid while using waveforms other than rectangular waves.

Order List

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 ($FF).

Pattern Editor

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:

  1. Notes
  2. Instrument numbers
  3. Volume
  4. Two characters before effect 1
  5. Two characters after effect 1
  6. Two characters before effect 2
  7. Two characters after effect 2
  8. Two characters before effect 3
  9. Two characters after effect 3
  10. Two characters before effect 4
  11. 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 ($00 - $FF) can be created for each track.

Settings Field

In the Settings Field you can adjust the module's metadata and performance settings of the song.

Tempo

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 0Fxx effect.

Speed

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 0Fxx effect.

Pattern Size

Sets the number of steps in the default pattern. The minimum value is 1, the maximum value is 256.

Groove

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 0Oxx effect.

Key commands

General

Key Command
Ctrl+N Create new module
Ctrl+O Open module
Ctrl+S Save module
Ctrl+P Open module property dialog
Ctrl+I Open current instrument editor
Return Play/stop song
F1 Show effect list dialog
F5 Play from start
F6 Play pattern
F7 Play from current position
F8 Stop song
Space Toggle jam/edit mode
Alt+L Focus on instrument list
Alt+O Focus on order list
Alt+P Focus on pattern editor
F12 Kill sound

Instrument list

Key Command
Insert Add instrument
Delete Remove instrument
Ctrl+I Open current instrument editor

Order list

Key Command
Ctrl+C Copy
Ctrl+V Paste
Ctrl+A Select track/all
Ctrl+D Duplicate order
Alt+D Clone order
Home Jump to first order
End Jump to last order
PageUp Jump to upper oder
PageDown Jump to lower oder
Insert Insert order below
Delete Delete order
Escape Deselect

Pattern editor

Key Command
Ctrl+C Copy
Ctrl+X Cut
Ctrl+V Paste
Ctrl+M Paste and mix
Ctrl+A Select track/all
Ctrl+G Interpolate
Ctrl+R Reverse
Ctrl+F1 Decrease note
Ctrl+F2 Increase note
Ctrl+F3 Decrease octave
Ctrl+F4 Increase octave
Alt+F9 Toggle track
Alt+F10 Solo track
Alt+S Replace instrument
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
Insert Insert step
BackSpace Delete the step above
Delete Delete commands
Escape Deselection
- Key off
* (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, .

Volume range

Minimum Maximum
FM 7F 00
SSG 00 0F
Drum 00 1F

It is able to reverse the order of FM volume (Configuration -> General -> Reverse FM volume order).

Effect list

Effect FM SSG Drum
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

File I/O

Module

The tracker enables to open and save to .btm (BambooTracker module file).

Instrument

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.

Export

The tracker can export a song to the following files.

  • .wav (WAVE file)
  • .vgm (VGM file)
  • .s98 (S98 file)

Language

BambooTracker supports following languages:

  • English (default)
  • French
  • Japanese

Build on Linux

On Ubuntu 18.04:

Dependencies

make
Qt5 (including qmake)
Qt5 Multimedia
Qt5 Multimedia plugins

sudo apt-get install \
  build-essential \
  qt5-default qtmultimedia5-dev libqt5multimedia5-plugins

Compilation

cd BambooTracker
qmake
make

Install package or build on FreeBSD

Build

To build the BambooTracker via FreeBSD ports

cd /usr/ports/audio/bambootracker
make install clean

Package

To install the package

pkg install bambootracker

Install package on Debian or Ubuntu

apt-get install bambootracker

Changelog

See CHANGELOG.md.

License

This program and its source code are licensed under the GNU General License Version 2.

See LICENSE and list.md of libraries.

Credits

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!
You can’t perform that action at this time.