Display your GitHub contribution graph on a 16x16 iDotMatrix BLE LED pixel display, powered by an ESP32-S3 running MicroPython.

• uv installed on your computer
• ESP32-S3-N16R8 board
• Anko 16x16 Bluetooth LED Pixel Display (iDotMatrix)
• USB-C cable for the ESP32

make

This runs uv sync to install esptool and mpremote into a local virtualenv.

# Download the correct firmware (spiram-oct variant):
# https://micropython.org/download/ESP32_GENERIC_S3/
# Select the SPIRAM-OCT variant (.bin file)

# Put ESP32-S3 in bootloader mode: hold BOOT, press RESET, release BOOT

# Erase flash
uv run esptool.py --chip esp32s3 --port /dev/ttyACM0 erase_flash

# Flash firmware (note: address 0x0, not 0x1000)
uv run esptool.py --chip esp32s3 --port /dev/ttyACM0 --baud 460800 write_flash 0 ESP32_GENERIC_S3-SPIRAM_OCT-*.bin

cp src/config.example.json src/config.json

Edit src/config.json:

• Set your WiFi SSID and password
• Set your GitHub username
• Create a GitHub Personal Access Token at https://github.com/settings/tokens (fine-grained, no extra permissions needed) and paste it in
• Optionally set ble_device_name to your display's full name (e.g., "IDM-825058") -- find it using the iDotMatrix mobile app or a BLE scanner

make install

This installs aioble on the device and copies all source files. To use a different serial port (e.g., on macOS):

make install PORT=/dev/cu.usbmodem1101

Press RESET on the ESP32 or power-cycle it. The device will:

1. Connect to WiFi
2. Sync the clock via NTP
3. Fetch your GitHub contributions
4. Connect to the iDotMatrix display via Bluetooth
5. Render your contribution chart
6. Repeat every hour

Monitor output via: uv run mpremote connect /dev/ttyACM0 repl

The built-in NeoPixel RGB LED (GPIO 48) indicates the current phase: