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.

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

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

It builds the following roms:

To set up the repository, see INSTALL.md.

Name		Name	Last commit message	Last commit date
Latest commit History 2,301 Commits
audio		audio
constants		constants
data		data
engine		engine
gfx		gfx
home		home
macros		macros
maps		maps
music		music
pic		pic
scripts		scripts
text		text
tools		tools
.gitattributes		.gitattributes
.gitignore		.gitignore
.gitmodules		.gitmodules
.travis.yml		.travis.yml
INSTALL.md		INSTALL.md
Makefile		Makefile
README.md		README.md
audio.asm		audio.asm
charmap.asm		charmap.asm
constants.asm		constants.asm
debug.asm		debug.asm
home.asm		home.asm
hram.asm		hram.asm
macros.asm		macros.asm
main.asm		main.asm
pokered.link		pokered.link
roms.md5		roms.md5
sram.asm		sram.asm
text.asm		text.asm
vram.asm		vram.asm
wram.asm		wram.asm