https://github.com/devdri/awake

Gameboy decompiler
https://github.com/devdri/awake

Last synced: 2 months ago
JSON representation

Gameboy decompiler

• Host: GitHub
• URL: https://github.com/devdri/awake
• Owner: devdri
• License: gpl-3.0
• Created: 2012-06-10T13:18:26.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2014-01-30T01:01:29.000Z (over 10 years ago)
• Last Synced: 2024-01-24T13:06:43.685Z (5 months ago)
• Language: Python
• Size: 704 KB
• Stars: 60
• Watchers: 9
• Forks: 14
• Open Issues: 2
• Metadata Files:
  • Readme: readme.txt
  • License: COPYING

Lists

• awesome-gbdev - awake - Game Boy decompiler. (Software Development / Tools)
• awesome-gb-dev-zh - 清醒

README

        
Awake - Gameboy decompiler

Author: Wojciech Marczenko (devdri) 

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!