Skip to content
disassembly of Pokémon Red/Blue
Assembly Python Other
Branch: master
Clone or download
Pull request Compare This branch is 78 commits ahead, 16 commits behind pret:master.
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.
audio
constants
data
engine
gfx
home
macros
maps
music
pic
scripts
text
tools
.gitattributes
.gitignore
.gitmodules
.travis.yml
INSTALL.md
Makefile
README.md
audio.asm
charmap.asm
constants.asm
debug.asm
home.asm
hram.asm
macros.asm
main.asm
pokered.link
roms.md5
sram.asm
text.asm
vram.asm
wram.asm

README.md

Pokémon Red and Blue, Real Music Edition

This is a ROM hack of Pokemon Red and Blue to include arbitrary waveform audio (which is not meant to be possible on a Gameboy).

You can include your own music by editing music/sources.yaml.

See tools/prepare_music.py for docs on that file.

Build instructions

  • Update music/sources.yaml with whatever music you want. The default currently has hard-coded paths to local files on my computer, so it won't work. Keep in mind that you only have 10 minutes of audio total.

  • Install python, youtube-dl, PyYAML, and ffmpeg. This will let you generate the music.

  • Install RGBDS as per normal instructions in INSTALL.md

  • make. You may need to touch music/sources.yaml then re-make multiple times, because of problems with the makefile that I ran out of time to diagnose.

Limitations

  • In stereo, music only plays in the left ear. Sound effects only play in the right. This is required due to the abuse of the volume control to get more sample range, which would distort sound effects if they shared the same volume control. Left and right volumes are controlled independently.

  • Cable club / trading will not work and may crash your game

  • There is only room for ~10min of audio in the cart. Some songs were cut and replaced with existing songs.

  • Because all the music I'm using is copyrighted, I can't include it in this repo. I hope at some point to make a version that sources entirely from online sources so anyone can build my version without needing the tracks on my local computer.

  • This isn't super well tested, you'll probably find bugs

    • For a start, something's buggy with the battle menu, causing a audible artifact

Original README:

This is a disassembly of Pokémon Red and Blue.

It builds the following roms:

  • Pokemon Red (UE) [S][!].gb md5: 3d45c1ee9abd5738df46d2bdda8b57dc
  • Pokemon Blue (UE) [S][!].gb md5: 50927e843568814f7ed45ec4f944bd8b

To set up the repository, see INSTALL.md.

See also

You can’t perform that action at this time.