PWNAGOTCHI BUILD GUIDE

Complete Hardware Options - From Budget to Best-in-Class (2019-2025)

🏆 Best Current Build (2025)

🥧 Raspberry Pi Options

Legacy
🥧

Raspberry Pi Zero W

Original Pwnagotchi Hardware

The "vanilla" hardware that Pwnagotchi was designed for. Uses 32-bit image.

  • CPU1GHz Single-core
  • RAM512MB
  • WiFi2.4GHz 802.11n
  • Architecture32-bit ARM
  • Image32-bit required
~$10-15

Pros

  • Original supported hardware
  • Low power consumption
  • Widely available

Cons

  • Slower performance
  • Single-core CPU
  • First boot takes 30+ min
Recommended
🚀

Raspberry Pi Zero 2 W

Best Performance Choice

5x faster than original with quad-core CPU. Uses 64-bit image for best performance.

  • CPU1GHz Quad-core
  • RAM512MB
  • WiFi2.4GHz 802.11n
  • Architecture64-bit ARM
  • Image64-bit recommended
~$15

Pros

  • 5x faster multi-threaded
  • Same form factor
  • Better thermal design

Cons

  • Slightly higher power draw
  • Requires newer images
Budget
💰

Raspberry Pi Zero WH

Pre-soldered Headers

Same as Zero W but with pre-soldered GPIO headers - no soldering required!

  • CPU1GHz Single-core
  • RAM512MB
  • HeadersPre-soldered
  • Architecture32-bit ARM
~$15

Pros

  • No soldering needed
  • Ready to use

Cons

  • Slower than Zero 2
  • Headers add height

📺 Display Options

Best Choice
📱

Waveshare 2.13" V4 HAT+

Latest Generation E-Paper

Newest version with HAT+ standard, onboard RTC, and improved PCB layout.

  • Resolution250×122 pixels
  • ColorsBlack & White
  • RefreshPartial supported
  • RTCOnboard
  • InterfaceSPI
  • Configwaveshare_4
~$20-25
Your Build
📺

Waveshare 2.13" V2

Officially Recommended

The officially supported e-ink screen with partial refresh support.

  • Resolution250×122 pixels
  • ColorsBlack & White
  • RefreshPartial supported
  • GhostingReduced vs V1
  • Configwaveshare_2
~$18-22
V1 Legacy
📟

Waveshare 2.13" V1

Original Display

First generation e-paper display. More ghosting than V2.

  • Resolution250×122 pixels
  • ColorsBlack & White
  • GhostingMore visible
  • Configwaveshare_1
~$15-18
🎨

Waveshare 2.13" V3

Intermediate Version

Requires special image from DrSchottky fork. Not officially supported.

  • Resolution250×122 pixels
  • SupportCommunity fork only
  • Configwaveshare_3
~$18-20
🌈

Inky pHAT

Pimoroni Alternative

Alternative e-paper display from Pimoroni. Requires specific case.

  • Resolution212×104 pixels
  • Colors3-color options
  • Configinky
~$25-30

⚠️ Displays NOT Supported

  • 3-Color Waveshare (B/C variants): Smaller resolution (104×212), slower refresh, not recommended
  • TFT/LCD displays: Work like HDMI displays - NOT supported by Pwnagotchi
  • OLED displays: Not officially supported
  • Larger e-paper (2.7", 3.7"): Not officially supported without custom modifications

🔋 Battery/UPS Options

Best Features
🔋

PiSugar 3

Latest Generation

Most advanced with upgradeable firmware, battery protection, and full software features.

  • Capacity1200mAh
  • Runtime~4-6 hours
  • Output5V/2.4A max
  • RTCYes (1 year standby)
  • I2CYes
  • FirmwareUpgradeable
  • ChargingUSB-C
~$40

Pros

  • Battery protection (80%)
  • Pi 5 compatible
  • Firmware updates

Cons

  • Higher price
Your Build
🔌

PiSugar 2

Popular Choice

Great balance of features and price. Has RTC and I2C for battery monitoring.

  • Capacity1200mAh
  • Runtime~4-6 hours
  • Output5V/2A max
  • RTCYes
  • I2CYes
  • ChargingUSB-C + MicroUSB
~$35-40
High Capacity

PiSugar 2 Plus

Extended Runtime

5000mAh battery for all-day operation. For Pi 3B/3B+/4B models.

  • Capacity5000mAh
  • Runtime~8-10 hours
  • Output5V/3A max
  • CompatiblePi 3B/3B+/4B
~$50
Budget
💵

PiSugar S

Basic UPS

Budget option with hardware-only features. No software battery monitoring.

  • Capacity1200mAh
  • Runtime~6 hours
  • Output5V/2A max
  • RTCNo
  • I2CNo
~$28

Pros

  • Lowest price
  • Simple operation

Cons

  • No battery level display
  • No scheduled wake-up
  • No software features
🔧

UPS-Lite V1.1

Alternative UPS

Feature-rich alternative with built-in UART→USB adapter for serial console.

  • Capacity1000mAh
  • I2CYes
  • SerialBuilt-in UART
  • Pluginups_lite
~$20-25
🔩

Geekworm X306

18650 Battery UPS

Uses replaceable 18650 battery cell for maximum runtime.

  • Battery18650 (not included)
  • Capacity2600-3500mAh
  • SwappableYes
~$15 + battery

Battery Comparison

Feature PiSugar S PiSugar 2 PiSugar 3
Capacity 1200mAh 1200mAh 1200mAh
Battery Level Display
RTC (Real-Time Clock)
I2C Communication
Scheduled Wake-up
Battery Protection ✓ (80%)
Firmware Upgradeable
Pi 5 Compatible
USB-C Charging
Price ~$28 ~$40 ~$40

🛠️ Complete Build Configurations

💰 Budget Build

Cheapest way to get started

~$55-65
🥧
Raspberry Pi
Pi Zero WH
~$15
📺
Display
Waveshare 2.13" V2
~$18
🔋
Battery
PiSugar S
~$28
💾
SD Card
Any 16GB
~$5

⚖️ Balanced Build

Good performance with essential features

~$75-85
🚀
Raspberry Pi
Pi Zero 2 W
~$15
📺
Display
Waveshare 2.13" V2
~$18
🔋
Battery
PiSugar 2
~$40
💾
SD Card
Samsung EVO 32GB
~$8

📦 3D Printed Cases

🎨

Thingiverse Cases

Multiple designs by out0fstep, elkentaro, rmrfus, and ohaithear

  • MaterialPLA recommended
  • Layer Height0.2-0.28mm
  • SupportsUsually not required
Browse Thingiverse →
🖨️

MakerWorld Cases

Modern designs optimized for Bambu printers with multi-color support

  • Best ForV4 + PiSugar 2/3
  • FeaturesVentilation, carabiner
Browse MakerWorld →
🥫

Altoid Tin

Classic hack - Pi Zero W + Waveshare fits in a large Altoid tin!

  • Cost~$3
  • No printerRequired

💾 Software Images

The original Pwnagotchi project is no longer maintained. Use these community forks:

jayofelony Fork

Most Active (v2.9.5.3)

  • 32-bitPi Zero W
  • 64-bitPi Zero 2 W
GitHub Releases →

aluminum-ice Fork

Alternative Community Fork

  • WaveshareV3/V4 support
GitHub Releases →

Example config.toml

# Pwnagotchi Configuration main.name = "pwnagotchi" main.lang = "en" main.whitelist = ["YourHomeNetwork"] # Display - Use correct type for your version! ui.display.enabled = true ui.display.type = "waveshare_2" # or waveshare_4 for V4 ui.display.color = "black" # Web UI ui.web.enabled = true ui.web.address = "0.0.0.0" ui.web.username = "changeme" ui.web.password = "changeme" # PiSugar2 Battery main.plugins.pisugar2.enabled = true main.plugins.pisugar2.shutdown = 5

📅 Pwnagotchi Hardware Evolution

2019

Original Release

Pwnagotchi released by evilsocket. Required Pi Zero W, Waveshare 2.13" V1, and external power bank.

2020

Battery Integration

PiSugar batteries became popular, enabling truly portable builds. Waveshare V2 released with better refresh.

2021

Pi Zero 2 W Released

Raspberry Pi releases Zero 2 W with quad-core CPU - 5x faster than original.

2022-2023

Community Forks

Original project stalls. jayofelony and aluminum-ice forks add Pi Zero 2 W support and newer display drivers.

2024-2025

Current Era

Waveshare V4 HAT+ with onboard RTC. PiSugar 3 with battery protection. 64-bit images standard for Pi Zero 2 W.

⚡ First Boot Tips

Critical First Boot Information

  • Use USB power, NOT battery for first boot (RSA key generation needs stable power)
  • Wait 10-30+ minutes - first boot generates RSA keys (do NOT interrupt!)
  • Cheap SD cards can take 30+ minutes - use Samsung/SanDisk
  • Green LED solid = booting, flashing = activity
  • E-paper blank at first is normal - wait for boot to complete
  • Connect via USB at 10.0.0.1:8080 (configure usb0 as 10.0.0.2)
  • SSH credentials: pi / raspberry (change immediately!)

🛒 Where to Buy

🛍️

Complete Kits