Home

Awesome

FlashGBX (by Lesserkuma)

for Windows, Linux, macOS (→ Download)

<img src="https://raw.githubusercontent.com/lesserkuma/FlashGBX/master/.github/01.png" alt="FlashGBX on Windows 11" width="500"><br><img src="https://raw.githubusercontent.com/lesserkuma/FlashGBX/master/.github/02.png" alt="GB Camera Album Viewer" width="500">

Introduction

Software features

Compatible cartridge reader/writer hardware

Installing and running

Pre-compiled binaries and packages

Available in the GitHub Releases section are pre-compiled downloads available for:

Run via Python

FlashGBX can also be run in a Python environment like so:

  1. Download and install Python (version 3.10.11 is recommended)
  2. Open a Terminal or Command Prompt window
  3. Install FlashGBX with this command:<br>pip3 install "FlashGBX[qt6]"

Running

Use this command in a Terminal or Command Prompt window to launch the installed FlashGBX application:

python3 -m FlashGBX

FlashGBX should work on pretty much any operating system that supports Qt-GUI applications built using Python with PySide2 or PySide6, pyserial, Pillow, setuptools, requests and python-dateutil packages. To run FlashGBX in portable mode without installing, you can also download the source code archive and call python3 run.py after installing the prerequisites yourself.

Note: On Linux systems, the brltty module may render serial communication devices non-accessible. See the troubleshooting section for details.

Cartridge Compatibility

Supported cartridge memory mappers

Currently supported flash cartridges

¹ = Cannot always be auto-detected, select cartridge type manually

Currently supported and tested reproduction cartridges

Many different reproduction cartridges share their flash chip command set, so even if yours is not on this list, it may still work fine or even be auto-detected as another one. Support for more cartridges can also be added by creating external config files that include the necessary flash chip commands.

¹ = Cannot always be auto-detected, select cartridge type manually

Troubleshooting

Miscellaneous

Contributors

The author would like to thank the following very kind people for their help, contributions or documentation (in alphabetical order):

2358, 90sFlav, AcoVanConis, AdmirtheSableye, AlexiG, ALXCO-Hardware, AndehX, antPL, aronson, Ausar, bbsan, BennVenn, ccs21, chobby, ClassicOldSong, Cliffback, CodyWick13, Corborg, Cristóbal, crizzlycruz, Crystal, Därk, Davidish, DevDavisNunez, Diddy_Kong, djedditt, Dr-InSide, dyf2007, easthighNerd, EchelonPrime, edo999, Eldram, Ell, EmperorOfTigers, endrift, Erba Verde, ethanstrax, eveningmoose, Falknör, FerrantePescara, frarees, Frost Clock, gandalf1980, gboh, gekkio, Godan, Grender, HDR, Herax, Hiccup, hiks, howie0210, iamevn, Icesythe7, ide, inYourBackline, iyatemu, Jayro, Jenetrix, JFox, joyrider3774, jrharbort, JS7457, julgr, Kaede, kane159, KOOORAY, kscheel, kyokohunter, Leitplanke, litlemoran, LovelyA72, Lu, Luca DS, LucentW, manuelcm1, marv17, Merkin, metroid-maniac, Mr_V, Mufsta, olDirdey, orangeglo, paarongiroux, Paradoxical, Rairch, Raphaël BOICHOT, redalchemy, RetroGorek, RevZ, RibShark, s1cp, Satumox, Sgt.DoudouMiel, SH, Shinichi999, Sillyhatday, simonK, Sithdown, skite2001, Smelly-Ghost, Sonikks, Squiddy, Stitch, Super Maker, t5b6_de, Tauwasser, TheNFCookie, Timville, twitnic, velipso, Veund, voltagex, Voultar, Warez Waldo, wickawack, Winter1760, Wkr, x7l7j8cc, xactoes, xukkorz, yosoo, Zeii, Zelante, zipplet, Zoo, zvxr

Third Party Notices and Licenses

Please view the <a href="https://raw.githubusercontent.com/lesserkuma/FlashGBX/master/Third Party Notices.md">Third Party Notices</a>.

DISCLAIMER

This software is being developed by Lesserkuma as a hobby project. There is no direct affiliation with Nintendo or any other company. This software is provided as-is and the developer is not responsible for any damage that is caused by the use of it. Use at your own risk!