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.
Step 2: Carefully solder the headers onto the raspberry pi
Step 3: Plug the Waveshare display into the raspberry pi
Step 4: Prepare the PiRTC to be put onto the raspberry pi
Step 5: Carefully solder the wires onto the PiRTC
Step 6: Carefully solder the PiRTC onto the raspberry pi
Step 7: Attach the Pisugar battery to the raspberry pi
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
Step 2: Download the Pwnagotchi zip file
Step 3: Unzip the Pwnagotchi zip file
Step 4: Open balenaEtcher and click "Flash from file"
(or your choice of microSD card flasher)
Step 5: Select the .img file from the folder you unzipped in step 3
Step 6: Click "Select target"
Step 7: Check the box with your microSD card and click "Select"
Step 8: Review the settings and then click "Flash"
Step 9: Wait for the program to finish flashing your microSD card
Step 10: On your desktop, create a new text file and rename it "config.toml"
Step 11: Copy the config template from the Pwnagotchi site and edit the settings to your liking.
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.
Step 13: Grab your raspberry pi and your microSD card
Step 14: Carefully place your microSD card into the raspberry pi's SD card slot
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.
Step 16: Wait for the raspberry pi to power on. You should see a green indicator light start flashing.
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.
FINISHED!
Congratulations, you are now finished building the pwnagotchi. Check out the pwnagotchi official website to learn how to use your new digital pet.