Skip to content


Build a Pwnagotchi WiFi penetration tester with Pi Zero and a PaPiRus display

Build a Pwnagotchi WiFi penetration tester with Pi Zero and a PaPiRus display

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.

Combined with the PaPiRus pHAT display, it makes the perfect little companion for sniffing local Wi-Fi network. Moreover, why not make it portable? We also added the PiJuice pHAT to the Pi Zero, with an additional LiPo battery allowing us to take this little gadget anywhere on the move.

Note: This tool is to be used for wireless penetration testing and must not be used for anything malicious

What you need

Getting Started

Step 1 – Header over to and download the latest pre-compiled image. Once downloaded Flash to your microSD card using Balena Etcher.

Step 2 – Before inserting the SD card into the Raspberry Pi we need to create a configuration file that the software will load on boot. You may need to eject the SD card and insert it into your computer again. Create a new file in the boot partition of the SD card called “config.yml” and add the following:

  name: 'pwnagotchi'
    - 'YourHomeNetworkMaybe'
      enabled: true
      report: true
        - 'YourHomeNetworkMaybe'

      enabled: true
      type: 'papirus'
      color: 'black'

Change “YourHomeNetworkMaybe” to your Wi-Fi SSID if you wish to exclude your Wi-Fi from the search.

Step 3 – Before we insert the SD card we need to assemble the hardware. Connect a stacking header to the Pi Zero:

Next connect the PiJuice Zero with the battery connected on top of the extending header:

Finally connect the PaPiRus display on top of the PiJuice Zero:

Step 4 – Insert the SD card into the Pi Zero and connect the power adaptor to the PiJuice Zero. Press the SW1 button to boot:

Step 5 – After a few moment the display will clear and then your pwnagotchi device will display the information on the PaPiRus display and it will automatically begin to search Wi-Fi networks.

Once the battery has been charge indicated by a green LED on the PiJuice Zero then you can disconnect the power supply and go for a walk.

For further information on fine tuning the settings and configuration please visit

Previous article Pi hole monitoring with the Media Center HAT
Next article How to Setup a Wireless Access Point on the Raspberry Pi