<p align="center">
<img src="https://raw.githubusercontent.com/williamckha/PyBoyAdvance/master/assets/pyboy_advance.svg" alt="PyBoy Advance" width="240">
</p>
---
PyBoy Advance is a Game Boy Advance emulator written in Python.
There are already plenty of fantastic GBA emulators out in the wild,
most written in languages far better suited than Python for emulator development.
This project is not meant to compete with those emulators nor match their
capabilities. In fact, PyBoy Advance is rather crap (and slow!) by comparison. I work on this project purely for fun,
with my end goal being to offer a highly readable implementation of a GBA emulator for educational purposes.
## Getting started
PyBoy Advance is written in pure Python and technically can be run with the standard CPython interpreter, but
performance will be unacceptably slow. Instead, you will need to run PyBoy Advance with [PyPy](https://pypy.org/),
a fast implementation of Python (see [Downloading and Installing PyPy](https://doc.pypy.org/en/stable/install.html)).
Install PyBoy Advance with `pip`:
```bash
$ pypy -m pip install pyboy-advance
```
You will need to provide a Game Boy Advance BIOS. Normatt's open source BIOS is supported and
available [here](https://github.com/Nebuleon/ReGBA/blob/master/bios/gba_bios.bin).
Launch PyBoy Advance from the terminal:
```bash
$ pyboy_advance --bios /path/to/bios.bin game_rom.gba
```
Or import and use it in your Python scripts:
```python
from pyboy_advance import PyBoyAdvance
emulator = PyBoyAdvance(rom="game_rom.gba", bios="/path/to/bios.bin")
emulator.run()
```
## Screenshots
<p align="center">
<img src="https://raw.githubusercontent.com/williamckha/PyBoyAdvance/master/assets/screenshot_kirby.png" alt="Screenshot of PyBoy Advance running Kirby: Nightmare in Dream Land" width="400">
</p>
## Acknowledgements
- [GBATEK](https://problemkaputt.de/gbatek.htm) by Martin Korth, the king of GBA hardware documentation
- [ARM7TDMI Technical Reference Manual](https://developer.arm.com/documentation/ddi0210/c/)
- [CowBite Virtual Hardware Specifications](https://www.cs.rit.edu/~tjh8300/CowBite/CowBiteSpec.htm) by Tom Happ
- [Tonc](https://www.coranac.com/tonc/text/toc.htm) by Jasper Vijn
- Excellent reference GBA emulators:
- [mGBA](https://mgba.io/) by Vicki Pfau (endrift)
- [NanoBoyAdvance](https://github.com/nba-emu/NanoBoyAdvance) by Fleroviux
- [Hades](https://github.com/hades-emu/Hades) by Arignir
- [RustBoyAdvance-NG](https://github.com/michelhe/rustboyadvance-ng/) by Michel Heily
- [GBA Tests](https://github.com/jsmolka/gba-tests) by Julian Smolka
- [PyBoy](https://github.com/Baekalfen/PyBoy) by Mads Ynddal (Baekalfen), a sister project (Game Boy emulator written in
Python)
Raw data
{
"_id": null,
"home_page": null,
"name": "pyboy-advance",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "gameboy, game boy, game boy advance, gameboy advance, emulator, pypy",
"author": "William Ha",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/ce/25/a8a9847c8f0bba4db0bdd3ddd9465f33fe2c53b1f810ff00cb69aaaf129b/pyboy_advance-0.0.2.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n <img src=\"https://raw.githubusercontent.com/williamckha/PyBoyAdvance/master/assets/pyboy_advance.svg\" alt=\"PyBoy Advance\" width=\"240\">\n</p>\n\n---\n\nPyBoy Advance is a Game Boy Advance emulator written in Python.\n\nThere are already plenty of fantastic GBA emulators out in the wild,\nmost written in languages far better suited than Python for emulator development.\nThis project is not meant to compete with those emulators nor match their\ncapabilities. In fact, PyBoy Advance is rather crap (and slow!) by comparison. I work on this project purely for fun, \nwith my end goal being to offer a highly readable implementation of a GBA emulator for educational purposes.\n\n## Getting started\n\nPyBoy Advance is written in pure Python and technically can be run with the standard CPython interpreter, but\nperformance will be unacceptably slow. Instead, you will need to run PyBoy Advance with [PyPy](https://pypy.org/),\na fast implementation of Python (see [Downloading and Installing PyPy](https://doc.pypy.org/en/stable/install.html)).\n\nInstall PyBoy Advance with `pip`:\n\n```bash\n$ pypy -m pip install pyboy-advance\n```\n\nYou will need to provide a Game Boy Advance BIOS. Normatt's open source BIOS is supported and\navailable [here](https://github.com/Nebuleon/ReGBA/blob/master/bios/gba_bios.bin).\n\nLaunch PyBoy Advance from the terminal:\n\n```bash\n$ pyboy_advance --bios /path/to/bios.bin game_rom.gba\n```\n\nOr import and use it in your Python scripts:\n\n```python\nfrom pyboy_advance import PyBoyAdvance\n\nemulator = PyBoyAdvance(rom=\"game_rom.gba\", bios=\"/path/to/bios.bin\")\nemulator.run()\n```\n\n## Screenshots\n\n<p align=\"center\">\n <img src=\"https://raw.githubusercontent.com/williamckha/PyBoyAdvance/master/assets/screenshot_kirby.png\" alt=\"Screenshot of PyBoy Advance running Kirby: Nightmare in Dream Land\" width=\"400\">\n</p>\n\n## Acknowledgements\n\n- [GBATEK](https://problemkaputt.de/gbatek.htm) by Martin Korth, the king of GBA hardware documentation\n- [ARM7TDMI Technical Reference Manual](https://developer.arm.com/documentation/ddi0210/c/)\n- [CowBite Virtual Hardware Specifications](https://www.cs.rit.edu/~tjh8300/CowBite/CowBiteSpec.htm) by Tom Happ\n- [Tonc](https://www.coranac.com/tonc/text/toc.htm) by Jasper Vijn\n- Excellent reference GBA emulators:\n - [mGBA](https://mgba.io/) by Vicki Pfau (endrift)\n - [NanoBoyAdvance](https://github.com/nba-emu/NanoBoyAdvance) by Fleroviux\n - [Hades](https://github.com/hades-emu/Hades) by Arignir\n - [RustBoyAdvance-NG](https://github.com/michelhe/rustboyadvance-ng/) by Michel Heily\n- [GBA Tests](https://github.com/jsmolka/gba-tests) by Julian Smolka\n- [PyBoy](https://github.com/Baekalfen/PyBoy) by Mads Ynddal (Baekalfen), a sister project (Game Boy emulator written in\n Python)\n",
"bugtrack_url": null,
"license": null,
"summary": "Game Boy Advance emulator written in Python",
"version": "0.0.2",
"project_urls": null,
"split_keywords": [
"gameboy",
" game boy",
" game boy advance",
" gameboy advance",
" emulator",
" pypy"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "6de7c5acf56808fed25ac385929ab8ddbbf4bcbd58fc6ede280d582ce7835675",
"md5": "e53baca35c17144c18d88b6b83995bd1",
"sha256": "a909065d41ae25d89ee2b65eab250845577face88802c917c3d24333a54fbcf6"
},
"downloads": -1,
"filename": "pyboy_advance-0.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e53baca35c17144c18d88b6b83995bd1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 47615,
"upload_time": "2025-07-26T05:49:46",
"upload_time_iso_8601": "2025-07-26T05:49:46.356903Z",
"url": "https://files.pythonhosted.org/packages/6d/e7/c5acf56808fed25ac385929ab8ddbbf4bcbd58fc6ede280d582ce7835675/pyboy_advance-0.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "ce25a8a9847c8f0bba4db0bdd3ddd9465f33fe2c53b1f810ff00cb69aaaf129b",
"md5": "7fa7b8fd64608142c4284cf72686fb27",
"sha256": "8e6e480aded158d7831ff36baface0d104ce16c32ec0bf09e282deeed7a50f6f"
},
"downloads": -1,
"filename": "pyboy_advance-0.0.2.tar.gz",
"has_sig": false,
"md5_digest": "7fa7b8fd64608142c4284cf72686fb27",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 36092,
"upload_time": "2025-07-26T05:49:48",
"upload_time_iso_8601": "2025-07-26T05:49:48.275586Z",
"url": "https://files.pythonhosted.org/packages/ce/25/a8a9847c8f0bba4db0bdd3ddd9465f33fe2c53b1f810ff00cb69aaaf129b/pyboy_advance-0.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-26 05:49:48",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "pyboy-advance"
}
JSON