A live RGBDS programming environment in the browser, allowing for realtime assembly programming for the Game Boy. Powered by webassembly builds of RGBDS and the Binjgb emulator.

Try online at gbdev.io/rgbds-live.

System requirements:

• bison, cmake
• emscripten working with 4.0.8 (you can change version with emsdk install 4.0.8 && emsdk activate 4.0.8)
• on windows prefered way is to install: cmake, msys2 (pacman -S bison flex)

Make sure you initialize submodules to be able to build the WebAssembly modules:

# Pull RGBDS-live, rgbds and binjgb sources
git clone https://github.com/gbdev/rgbds-live --recursive

then

# Do a full build
./build.sh

or alternatively(or on windows):

npm ci
emcmake cmake -B build
cmake --build build

To start hacking, use the development server:

# Development server with live refresh:
npm run dev