Skip to content
Game Boy sound emulator & .gbs player
C++ Makefile
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src
.gitignore
LICENSE
Makefile
README.md

README.md

gbs_player

A program for playing Game Boy sound (.gbs) files.

Do note that this is very much a work in progress.

TODO

  • Proper sound filter & resampling
  • Game Boy Color support
  • Platform independent controls
  • Pass blargg's sound tests
  • Sound visualizations

Compile

Dependencies:

  • libao (for audio output)

To compile, do

make

in the project root directory.

To compile with debugging support, gbz80-disasm must configured.

Note: Only works on Linux for now, as the terminal controls are platform dependent.

Usage

Run the program with your .gbs file as an argument:

$ ./player 
Usage: ./player <gbs-file>

Controls

  • n: next song
  • p: previous song
  • q: quit player

Example

$ ./player DMG-TRA-0.gb
GBS version:      1
Song count:       17
First song:       1
Load address:     0x64e5
Init address:     0x64e5
Play address:     0x6553
Stack pointer:    0xcfff
Timer modulo:     0x0
Timer control:    0x0
Title:            Tetris v1.0
Author:           Hirokazu Tanaka
Copyright:        1989 Nintendo
Playing song no. 1

cue music

You can’t perform that action at this time.