ButtonBassScript (BBS) Help

Use commands to create complex songs! Commands outside `!TRACK` blocks are **Global**.

Multi-Tracking

Define separate, **simultaneous** tracks. Commands inside are **Track-Specific**.

!BPM 120  #-- Global tempo

!TRACK drums {
  !T_SOUND notes2   #-- Track-specific sound
  !T_VOLUME 70     #-- Track-specific volume
  !REPEAT 4 { [=] _ [;] _ }
}
!TRACK melody {
  !T_SOUND aguitar
  !PLAY main_riff
}

Per-Note Effects

Add effects inside note brackets: `[key:vol,pan!]`

#-- Play 'c' at 50% vol, panned 100% left, staccato
[c:50,L100!]

#-- Play 'q' at 80% vol
[q:80]

#-- Play 'w' panned 50% right
[w,R50]

Global Commands

Control the master playback.

#-- This is a comment
!BPM 180         #-- Master speed
!VOLUME 80       #-- Master volume (0-100)
!PAN L50         #-- Master pan (L100 to R100)
!STOP            #-- Stop all tracks

Track-Level Commands

Control flow inside a `!TRACK` or `!DEF` block.

!DEF verse { ... }   #-- Define a phrase
!PLAY verse          #-- Play a defined phrase
!REPEAT 4 { ... }    #-- Loop a block
!DELAY 3             #-- Pause for 3 beats
!LABEL my_loop       #-- Create a jump bookmark
!JUMP my_loop        #-- Jump to bookmark

Global FX Chain

Apply master effects to all tracks.

#-- Set a low-pass filter
!FILTER_TYPE lowpass
!FILTER_FREQ 800
!FILTER_Q 5

#-- Add a stereo echo
!DELAY_TIME 0.5    #-- (in seconds)
!DELAY_FEEDBACK 0.4  #-- (0.0 to 1.0)

Full Song Template

Copy this entire block, paste it into the song box, and press Play! Use it as a starting point for your own songs.

#-- --- My First Song ---
!BPM 110
!VOLUME 100

#-- --- Definitions ---
#-- (Define phrases to reuse)
!DEF beat {
    #-- Kick drum on 1, snare on 3
    #-- Use per-note volume (:xx) for accents
    [=:100] _ [;:80] _
}
!DEF hat_pattern {
    #-- Quiet 8th-note hi-hats
    [~:50] [~:40] [~:50] [~:40]
}
!DEF bass_line {
    z _ _ _ c _ _ _
}
!DEF melody {
    q _ e _ r _ t _
    y _ u _ i _ o _
}

#-- --- TRACKS ---
#-- (These all play at the same time)

!TRACK drums {
    !T_SOUND notes2
    !T_VOLUME 80
    
    !LABEL loop
    !PLAY beat
    !PLAY beat
    !JUMP loop
}

!TRACK hihats {
    !T_SOUND notes2
    !T_VOLUME 50
    
    !LABEL loop
    !PLAY hat_pattern
    !PLAY hat_pattern
    !JUMP loop
}

!TRACK bass {
    !T_SOUND organ2
    !T_VOLUME 100
    
    !DELAY 4 #-- Wait 4 beats
    
    !LABEL loop
    !PLAY bass_line
    !PLAY bass_line
    !JUMP loop
}

!TRACK melody {
    !T_SOUND pluck
    !T_VOLUME 90
    
    !DELAY 8 #-- Wait 8 beats
    
    !LABEL loop
    !PLAY melody
    !JUMP loop
}

!TRACK fx {
    #-- This track adds a filter sweep
    !DELAY 16
    !FILTER_TYPE lowpass
    !FILTER_Q 3
    !FILTER_FREQ 500
    !DELAY 4
    !FILTER_FREQ 1000
    !DELAY 4
    !FILTER_FREQ 3000
    !DELAY 4
    !FILTER_FREQ 20000
}