# FoloToy AI Passport, rebuilt as a Pip-Boy clock

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.

- Category: Interface (mod)
- Device: [FoloToy AI Passport](https://afterware.xyz/d/folotoy-ai-passport)
- Made by: [ricroad](https://github.com/ricroad) on GitHub
- Original: https://github.com/ricroad/folotoy-pipboy-living-clock
- On Afterware: https://afterware.xyz/p/folotoy-ai-passport-rebuilt-as-a-pip-boy-clock

## Can I build this?

- Difficulty: Beginner
- AI-buildability: 5/5 (It's all firmware for an off-the-shelf ESP32-C3 device, and the repo ships with AGENTS.md and pin maps so an AI agent can write and extend the code with little guesswork.)
- Time: An evening
- Cost: $15–30
- Parts: ESP32-C3, ST7789P3 240x320 display, ES8311 audio codec, CW2017 battery gauge
- Tools: USB-C cable, ESP-IDF toolchain, computer

Estimates based on the original write-up. How the AI-buildability score works: https://afterware.xyz/ai-buildability

## Build sheet

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

## 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.
```

## 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

- [Repository](https://github.com/ricroad/folotoy-pipboy-living-clock)
- [FoloToy AI Passport](https://github.com/FoloToy/ai-passport)

Tags: esp32-c3, lvgl, pip-boy, pomodoro, st7789, firmware, esp-idf, vibe-coded

AI assistants can search all Afterware builds through the MCP server at https://afterware.xyz/mcp (setup: https://afterware.xyz/agents).