Intalling RGBDS on Windows

  1. First, pick the version you want to install. If you want to use master instead of a release, go here.
  2. Follow the “release page” link below “GitHub links”, and grab either of the win32 (for 32-bit Windows) or win64 (for 64-bit Windows) .zip files, near the bottom of the page.
  3. Unzip that file, you should get the .exe files alongside a couple of .dlls.
  4. Either:
    • Put all of the files in your project’s directory
    • Put all of the files in a directory already in the PATH
    • Put all of the files in a directory, then add it to the PATH, using the path command, the set command, the permanent setx command, or any other method. For example: setx PATH=%PATH%;C:\Programs\rgbds-0.3.8-win64\win64
  5. Profit! RGBDS can now be used from your favorite command line (cmd.exe or PowerShell, most likely)

Cygwin

Follow steps 1 to 3 of the instructions above; then, copy all of the .exe and .dll files to the /usr/local/bin directory of Cygwin’s installation. With the default settings, that should be C:\\cygwin64\\usr\\local\\bin. Do not put them in a subdirectory! (e.g. C:\\cygwin64\\usr\\local\\bin\\rgbds) This would not work.

After that, you should be able to use RGBDS from within the Cygwin terminal, which you can confirm by running rgbasm -V.

WSL, MSYS2, and other Linux-like environments

For these, you have to build from source. On WSL, you should install any prereqs using apt-get (example: sudo apt-get install libpng-dev). On MSYS2, use pacman (example: sudo pacman -S mingw-w64-libpng).