Desktop Version

The game can be run on your computer using pygame, which allows you to experiment with it without needing to setup an ESP32.

Requirements

• Python 3
• pygame (pip install pygame)

If your system Python is externally managed (e.g. Homebrew on macOS), use a virtual environment:

python3 -m venv venv
source venv/bin/activate
pip install pygame

Running

From the src/ directory:

python main_desktop.py

Controls

Key	Action
Arrow keys	D-pad
Z / X	A / B
A / S	Menu 1 / Menu 2
Escape	Quit (saves first)

Save file

The desktop save is stored at src/save.json, separate from the device save at /save.json on the ESP32.