How to Build a Pwnagotchi Step-By-Step

Date: 8/22/2020 | Project title: Jeff's Pwnagotchi

Image of Pwnagotchi

What is Pwnagotchi?

Pwnagotchi is a handheld digital pet for hacking Wi-Fi that gets smarter as it visits more Wi-Fi networks. Pwnagotchi learns by capturing Wi-Fi messages while their owner takes them for walks. Pwnagotchi is a fun hacking project that can be built with a simple Raspberry Pi Zero.

How does it work?

Pwnagotchi is an A2C-based “AI” powered by bettercap that learns from its surrounding WiFi environment in order to maximize the crackable WPA key material it captures (either through passive sniffing or by performing deauthentication and association attacks). This material is collected on disk as PCAP files containing any form of crackable handshake supported by hashcat, including full and half WPA handshakes as well as PMKIDs.

Materials Needed

  1. Raspberry Pi Zero W

  2. 40-Pin (2x20) Male Header

  3. Waveshare eInk 2.13” 250x122 Display HAT V2

  4. SanDisk 32GB microSD (rated UHS-I or above)

  5. Adafruit PiRTC PCF8523 Real Time Clock

  6. CR1220 3V Lithium Coin Cell Battery

  7. USB to Micro USB cable (must support data transfer)

  8. Pisugar Portable Battery for Raspberry Pi Zero (not pictured)

Image of Materials

Tools Needed

  1. Lead-free Rosin Core Solder

  2. No-Clean Solder Wick

  3. Saftey Glasses

  4. Tweezers

  5. 22 Gauge Electrical Wire

  6. Soldering station

Image of Tools

Building the Pwnagotchi

Step 1: Place the headers onto the raspberry pi

Image of Step 1

Step 2: Carefully solder the headers onto the raspberry pi

Image of Step 2

Step 3: Plug the Waveshare display into the raspberry pi

Image of Step 3

Step 4: Prepare the PiRTC to be put onto the raspberry pi

Image of Step 4

Step 5: Carefully solder the wires onto the PiRTC

Image of Step 5

Step 6: Carefully solder the PiRTC onto the raspberry pi

Image of Step 6

Step 7: Attach the Pisugar battery to the raspberry pi

Image of Step 7

Finished! Now you are ready to begin flashing the microSD card

Installing the Pwnagotchi software

Step 1: Grab your microSD card and plug it into your computer

Image of Step 1

Step 2: Download the Pwnagotchi zip file

Image of Step 2

Step 3: Unzip the Pwnagotchi zip file

Image of Step 3

Step 4: Open balenaEtcher and click "Flash from file"

(or your choice of microSD card flasher) Image of Step 4

Step 5: Select the .img file from the folder you unzipped in step 3

Image of Step 5

Step 6: Click "Select target"

Image of Step 6

Step 7: Check the box with your microSD card and click "Select"

Image of Step 7

Step 8: Review the settings and then click "Flash"

Image of Step 8

Step 9: Wait for the program to finish flashing your microSD card

Image of Step 9

Step 10: On your desktop, create a new text file and rename it "config.toml"

Image of Step 10

Step 11: Copy the config template from the Pwnagotchi site and edit the settings to your liking.

Image of Step 11

Step 12: Once you are finished editing the config.toml, copy the file to the root directroy of your microSD card.

Make sure that you are placing a COPY of the file onto the microSD card. The pwnagotchi will delete the file everytime it boots up. So make sure you have a copy. If your microSD card does not show up in your file explorer, unplug it and plug it back in. Then it should show up. Image of Step 12

Step 13: Grab your raspberry pi and your microSD card

Image of Step 13

Step 14: Carefully place your microSD card into the raspberry pi's SD card slot

Image of Step 14

Step 15: Power on the raspberry pi

Make sure to plug the USB cable into the port on the LEFT. The micro USB port on the left is the power port and is for normal use. The micro USB port on the right is the maintenance port and is used to retrieve data from your pwnagotchi. Image of Step 15

Step 16: Wait for the raspberry pi to power on. You should see a green indicator light start flashing.

Image of Step 16

Step 17: Once it's powered up, DO NOT TURN OFF. Wait for the first-boot initialization to finish.

Make sure that you DO NOT INTERRUPT the first-boot initialization. This step could take a while to finish. When it is done, the message will change.
Image of Step 17

FINISHED!

Congratulations, you are now finished building the pwnagotchi. Check out the pwnagotchi official website to learn how to use your new digital pet. Image of Step 18