Metadata-Version: 2.1
Name: gameboy-python
Version: 0.1.0
Summary: Game Boy Emulator in Python
Home-page: https://github.com/LittleNyima/gameboy-in-python
Author: LittleNyima
Author-email: littlenyima@163.com
License: GPLv3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/markdown
License-File: LICENSE

# Game Boy in Python

A Game Boy emulator implemented with pure Python (abbr. **GBP**). GBP is a very simple implement and is able to run some of the GameBoy games (e.g., Dr. Mario). GBP has also passed the blargg's CPU instruction tests.

However, due to its simplicity and Python's performance bottleneck, the frame rate is usually only 3 or 4 (tested on the Apple M1 pro silicon).

Feature not implemented:

- Cartridge MBCs.
- Audio.
- Game Boy Color / Super Game Boy functionalities.
- Bootstrap and so on.

# Usage

```shell
gameboy [-h] [--debug] gamerom
```

- `gamerom`: Path to the game ROM file.
- `-h` `--help`: Show the help message and exit.
- `--debug`: Enable debugging mode.

# References

- **[gbdev/pandocs](https://github.com/gbdev/pandocs)**
- **[gbdev/rgbds](https://github.com/gbdev/rgbds)**
- **[Baekalfen/PyBoy](https://github.com/Baekalfen/PyBoy)**
- **[rockytriton/LLD_gbemu](https://github.com/rockytriton/LLD_gbemu)**
