ONE SONG

1. Write the tune in VB Noise. Play it here first.
2. FILE → Export SONG.H (same bytes as .VBM). Optional: also Export .VBM to keep a copy.
3. Copy into your VBDE / gccVB project (once): vbde/vbt_hw.h, vbt_tables.h, vbt_player.h, vbt_player.c (+ vbt_vbeat_data.h if drums need it — include whatever the example already includes).
4. Drop in your song.h (or replace vbde/example/song.h).
5. After VIP/WRAM init, while every VSU channel is off:

   #include "vbt_player.h"
   #include "song.h"
   vbt_init(vbt_song);  /* loads 5 waves — hardware ignores wave writes if a ch is on */
   vbt_play();
   /* 50 Hz: timer IRQ preferred (reload 199, T-Clk-Sel=0 → 20 ms), or once per VIP frame */
   vbt_update();

6. Add vbt_player.c to the makefile / build.bat compile list. Run build.bat → a .vb ROM.
7. Open that .vb in Lemur (git.virtual-boy.com/PVB/lemur). It should match Play in the browser.

This repo does not ship gccVB. FILE → Export to .VB is a server/VBDE convenience for a standalone player ROM, not the game-embed path.

MANY SONGS

• Export one .h per tune. Rename each file AND the symbols vbt_song / vbt_song_size so they don’t clash (e.g. vbt_hanger / vbt_hanger_size in hanger.h).
• Same player .c/.h once. Switch tracks with channels off:

  vbt_stop();
  vbt_init(vbt_hanger);
  vbt_play();

• Keep calling vbt_update() at 50 Hz. Don’t rewrite wave RAM while a channel is on.
• Don’t call vbt_update in a tight loop.

DON’T

• Rewrite waves while a channel is enabled.
• Pretend CH6 plays a wavetable.
• Implement PCM in vbt_update.