Prepare the card.
Use a FAT32 microSD card. Download the SD starter, unzip it, and copy its contents to the card’s root—not inside another folder.
Download SD starter ↓Artwork and folder structure only. No ROMs or movies included.
THE YELLOWB0I MIX
Music composed by DJ Anubis
Press Play for some background music.
THE YELLOWB0I WORKSHOP / 001
SMALL SCREEN.
BIG ENERGY.
Your games. Your movies. Your little yellow machine.
Everything you need to get it up and running, right here.
2.8″ + 3.2″ ESP32GAME BOY / GAME BOY COLORMADE TO MAKE YOURS
READY, PLAYER YOU.
OUR TOUCH CONTROLS
01 / THE STARTING LINE
FLASH YOUR
YELLOWB0I.
One cable. The right board.
A fresh start for your YellowB0i.
INSTALL FIRMWAREOUR BUILD · v1.32.3
Check the label on your board, then choose its matching display. These builds are not for ESP32-S3 boards.
2. Plug in. Connect. Install.
Use a USB data cable. Close any serial monitor first. Keep the device plugged in until installation finishes.
Having trouble connecting?
Use desktop Chrome or Edge with this page opened over HTTPS. Try another data cable or USB port. Close Arduino IDE, PlatformIO monitors, or other flashers. If it stays on “Connecting,” hold BOOT while connecting, then release when writing starts.
If there is no serial port, your board may need its USB-to-serial driver. Check the USB chip model on the board before installing a driver.
02 / YOUR POCKET CINEMA
MOVIE NIGHT.
POCKET SIZE.
Turn a video into files
your YellowB0i can actually play.
MOVIE CONVERTERSTAYS ON YOUR COMPUTER
03 / BRING YOUR OWN ADVENTURE
LOAD YOUR
NEXT ADVENTURE.
A few folders. Your own games.
That’s the setup.
Add your games.
Put Game Boy .gb files in /roms/gb/ and Game Boy Color .gbc files in /roms/gbc/. Extract ZIP archives first.
Use your own lawfully obtained games. Give each game a unique filename so saves don’t share a name.
Play. Save. Come back.
Insert the card, start YellowB0i, and choose a game. Use the game’s own Save option, then wait at least six seconds before switching off.
Cartridge save data goes into /saves/. This keeps supported in-game progress; it isn’t an instant save state.
THE CARD, AT A GLANCE
A home for
every file.
Keep the SD card organized.
YellowB0i takes it from there.
SD CARD /
├── roms/
│ ├── gb/ Game Boy .gb files
│ └── gbc/ Game Boy Color .gbc files
├── saves/ Your game’s .sav + .sav.bak
├── movies/
│ ├── MyMovie.raw
│ ├── MyMovie.pcm
│ └── MySeries/
│ ├── Episode 01.raw
│ └── Episode 01.pcm
└── ui/ Menu artwork from the starterMy game isn’t saving. What should I check?
Not every game supports cartridge saves. Saving cartridge RAM doesn’t create a resume-anywhere snapshot. Use the game’s actual save system first. YellowB0i’s manual Save menu or quitting the ROM can also flush that data. If “SAVE FAILED” appears, check that the card is writable and has free space; use the serial log to look for [SAVE] and [SD] messages. Keep .sav.bak files as recovery copies. Continuous RAM writes or SD errors may delay autosave—six seconds is a waiting recommendation, not a guarantee.
04 / THE GOOD STUFF
BUILD IT.
MAKE IT YOURS.
Plain cases. Parts lists.
Everything in the right place.
Audio hardware for both 2.8″ and 3.2″ builds: an 8 Ω, 1 W speaker with a two-pin connector. Match the connector to your board’s speaker socket.
3D PRINT2.8″ plain caseFront + back STL↓3D PRINT3.2″ plain caseFront + back STL↓3D PRINT3.5″ plain caseAlmost completed—BUILD GUIDE2.8″ materials & wiringParts + build record↓BUILD GUIDE3.2″ materials & wiringParts + build record↓FIRMWAREChoose your board firstFull BIN · v1.32.3↑
Can I flash from my phone?
Use a desktop computer with Chrome or Edge and a USB data cable. This installer needs Web Serial and a secure HTTPS connection.
Where are the logos on the cases?
These downloads are plain, logo-free models. For case designs with logos and custom artwork, visit ZeekSecLabs.com ↗.
Where is the source?
The public repository is being prepared. This page will link to it when its URL is confirmed.
