Interface · mod

FoloToy AI Passport, rebuilt as a Pip-Boy clock

ricroadon GitHub

Open-source ESP32-C3 firmware that turns the FoloToy AI Passport into a Pip-Boy-style desk clock with a walking Vault Boy animation and 25, 50 and 90 minute mission timers.

Build sheet

Device page: FoloToy AI Passport →
Device: FoloToy AI Passport
Display: ST7789P3 240x320 SPI
Controller: ESP32-C3
Language: C, ESP-IDF, LVGL

Can I build this?Beginner · AI 5/5 · $15–30

Difficulty: Beginner
AI-buildability: 5/5
Time: An evening
Cost: $15–30

Parts

ESP32-C3 ST7789P3 240x320 display ES8311 audio codec CW2017 battery gauge

Tools

USB-C cableESP-IDF toolchaincomputer

Starter prompt

Based on "FoloToy AI Passport, rebuilt as a Pip-Boy clock" on Afterware: https://afterware.xyz/p/folotoy-ai-passport-rebuilt-as-a-pip-boy-clock

Using ESP-IDF and LVGL on an ESP32-C3 with a 240x320 ST7789 SPI display, three buttons read from one ADC pin via a resistor ladder, and a backlight on LEDC, write a desk clock with a 25/50/90 minute countdown timer. Use a screen-off timeout after 20 seconds of inactivity and keep display and button code behind a small board support layer.

Estimates based on the original write-up. How AI-buildability is scored. The maker built this with AI tools: more vibe-coded builds. Building with an AI assistant? Connect it to Afterware (free MCP server).

Story

The FoloToy AI Passport is a small ESP32-C3 device with a 240 x 320 portrait ST7789 display, three shared ADC buttons, an ES8311 audio codec and a CW2017 battery gauge. This project replaces its software with a Pip-Boy-style living clock. The screen shows an eight-frame walking Vault Boy animation, a clock, and a mission select screen with 25, 50 and 90 minute timers.

The firmware adds USB clock sync, a battery readout fallback, a quest-complete cue, a cold-boot power-up sound, and automatic screen-off after 20 seconds of inactivity. The interface is driven by LVGL on top of a board support package that isolates pins and panel settings from the application code.

The repository is written as a baseline for AI coding agents. It includes an AGENTS.md file and a hardware development guide that record pin maps, panel initialization, ADC thresholds and memory limits, so an agent can add new applications without guessing at board behavior. The project is a non-commercial fan build and is not affiliated with FoloToy, Bethesda or ZeniMax.

Resources · 2

Repository FoloToy AI Passport