CircuitPython LAMEBOY

This is a set of libraries for CircuitPython to make use of the Lameboy device.

What is Lameboy? It's a small handheld device with buttons, screen and an ESP8266 microcontroller designed by Davedarko. For more information see:


First you need to flash CircuitPython onto the device. Get the utility, get the CircyitPython image for the HUZZAH, and flash it: --port /dev/ttyUSB0 erase_flash --port /dev/ttyUSB0 write_flash 0 adafruit-circuitpython-feather_huzzah-2.2.3.bin

Verify it was successful by connecting to the REPL:

screen /dev/ttyUSB0 115200

After you press ENTER a few times, you should see the Python prompt: >>>.

Next, you need to get the Ampy utility and use it to copy the files onto the device:

ampy --port /dev/ttyUSB0 put
ampy --port /dev/ttyUSB0 put

Now you can import lameboy and use it to access the device's hardware.


The library is a compatibility layer for the PewPew FeatherWing device. It lets you play the games written for PewPew.

Just copy the game files onto the device with ampy, and import them on the REPL. You can also use the program included in this repository to select which game to play. If you create a file with just:

import menu

in it, it will start automatically on the device power on.