A modern adapter to save GameBoy Camera photos to your PC or Phone via Web Interface.

---

📸 Features

🖼️ Web Gallery Real-time photo receiving	🎨 Color Palettes Retro GB & GBC styles
🖨️ Printer Mode Print from PC to GameBoy	📱 Mobile Ready iOS & Android Support

🚀 Getting Started

1. Build or Buy: Get a Raspberry Pi Pico and follow the Schematics below.
2. Flash: Download the latest .uf2 from Releases or build it yourself.
3. Connect: Plug it into your PC/Phone. It will appear as a USB Ethernet device.
4. Open: Navigate to http://192.168.7.1/ in your browser.

---

🛠️ Compatibility Modes

The adapter features two specialized modes to ensure it works across all your devices. Switch via Web UI Settings or Serial commands.

• 🍏 iOS + Desktop (Default): Optimized for Apple devices. Prioritizes the Web Interface.
• 🤖 Android + Desktop: Enables USB Serial (CDC) for use with the Android Companion App.

⌨️ Serial Commands

If the web UI is unreachable, use a serial terminal to send:

• GET /set_mode_ios / GET /set_mode_android
• GET /update (Reboots to Bootloader)

---

📟 Modes of Operation

📥 Scanner Mode (Default)

Acts as a virtual Game Boy Printer. Simply select "Print" on your Game Boy, and photos will appear instantly in the web gallery.

📤 Printer Mode

Click the Logo in the web interface to switch. Upload any image from your device to print it on a real Game Boy Printer connected to the adapter. Includes Live Preview and Exposure Control.

---

🔌 Schematics

💡 Hardware Tips

• Uses GPIO 8 for the Status LED.
• Uses GPIO 9 for the Action Button.
• Requires a 5V to 3.3V level shifter for safe operation with the Game Boy's 5V logic.

Example of a finished build.

---

🐳 Docker Build

Build the firmware without installing any local dependencies:

git clone --depth 1 https://github.com/antoxa2584x/gameboy-camera-adapter
cd gameboy-camera-adapter
git submodule update --init
./build.sh

---

🤝 Credits & Links

• Based on pico-gb-printer.
• Protocol insights from Raphael-Boichot.
• RetroGaming UA