/awake

Gameboy decompiler
  1. Python 99.8%
  2. CSS 0.2%
Switch branches/tags
Nothing to show
Find file
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Download ZIP

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching Xcode...

If nothing happens, download Xcode and try again.

Launching Visual Studio...

If nothing happens, download the GitHub extension for Visual Studio and try again.

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!