Gameboy decompiler
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
awake
data
roms
upgradedb
.gitignore
.project
.pydevproject
COPYING
awake.json
favicon.ico
gui_export.py
gui_server.py
main.py
note.txt
readme.txt
sprite-finder.py
style.css
upgrade_database.py

readme.txt

Awake - Gameboy decompiler
Author: Wojciech Marczenko (devdri) <wojtek.marczenko@gmail.com>
License: GPLv3
Python version: 2.7 (some features require PIL)

Quick start:
	The program can run in two modes: window and webbrowser. To start, just run:
		python main.py
	This will open the main window. You can also directly open a rom:
		python main.py roms/zelda.gb
	Or even a location within rom:
		python main.py roms/zelda.gb /proc/40
	To run a headless http server on port 8888:
		python main.py roms/zelda.gb --server
		Then browse to http://localhost:8888/proc/0000:0150
Note:
	Use zelda.gb (MD5: c4360f89e2b09a21307fe864258ecab7) for best results.

Also note:
	To see cooler stuff you will need to run analysis which discovers code. Generate graphviz graphs. Sometimes manually override jumptable limits. This is not yet supported in user-friendly way and will require hacking the python code. Look at graph.py for examples. Warning: the code is a mess.

Third note:
	Many compatibility-breaking changes are coming and stuff will break, but stay tuned for cool new features.

Have fun!