How to Make a Pwnagotchi

by El3ctron in Circuits > Raspberry Pi

100 Views, 1 Favorites, 0 Comments

How to Make a Pwnagotchi

IMG_1986.jpeg

Hi! my name is Jesse and im a 15 yr old student in Arizona. today ill show you how to make a pwnagotchi. feel free to ask if you have any questions.

A Pwnagotchi is a wifi hacking device that uses ai and it uses bettercap, and it captures wifi handshakes. you can then use these handshakes for many things such as cracking the password. disclaimer: this is only for educational purposes- DO NOT USE THIS ON OTHER WIFIS, unless you have permission or it is your own wifi.

Supplies

you will need

  1. an sd card + sd card reader 8gb minimum
  2. a raspberry pi 0w
  3. a battery (pisugar s,2,3 will work best)
  4. the waveshare v2 (is the official one, i used a waveshare v4 with some help from github)
  5. a computer
  6. a small screwdriver
  7. a micro usb cable that carries data

The Hardware

IMG_1990.jpeg

the battery has some tape over the holes so poke those holes out. then screw the battery board onto the back of the pi, make sure the pins on the back are making contact with the battery

Install the Screen

IMG_1989.jpeg

just push down the screen onto the raspberry pi's pins, make sure to be gentle and dont force anything. it does take some pressure to install it.

(optional) Get a Case

you can 3d print or buy a case for your pwnagotchi. I've linked one here that will work with this configuration.

Flash the Image

image_2025-07-25_195019475.png
image_2025-07-25_195220130.png

download balena etcher here: https://etcher.balena.io/

next, download the file here by clicking code, the download zip: https://github.com/evilsocket/pwnagotchi

extract the zip file, then open balena etcher and select flash from file

open the image file

select your storage and click flash

Ethernet Settings

image_2025-07-25_200405859.png
IMG_1991.jpg

plug the sd card in to the pwnagotchi, then plug the micro usb cable into your pc and into the port shown above (only that port or it will not work)

now go and open device manager on your pc

it should show up as a network adapter, if it doesnt, you have an extra step :( (top right)

if you do have it then go to your ethernet settings, then click "change adapter options" on the right. :D

you should have a new ethernet device you dont recognize(bottom left) it should say RNDIS gadget.

right click on that and click properties. scroll down until you see internet protocol version 4 and click properties


Ethernet Settings

image_2025-07-25_201102198.png
Screenshot 2025-07-25 201741.png
image_2025-07-25_202025301.png

if you do have it then go to your ethernet settings, then click "change adapter options" on the right. :D

you should have a new ethernet device you dont recognize(bottom left) it should say RNDIS gadget.

right click on that and click properties. scroll down until you see internet protocol version 4 and click properties, yours should look like the one shown above. if it doesnt, make it.

close out of that and go to your ethernet or wifi, click properties, then sharing.

you want to make sure that it is sharing with your pwnagotchi (ethernet 6 in this case)

you can now close everything.

Extra Step :(

dont worry, its not hard. you just have to download a driver here: https://modclouddownloadprod.blob.cor...

then unzip it and click on the RNDIS.inf file

Open Up Powershell

Screenshot 2025-07-25 202943.png
Screenshot 2025-07-25 203245.png

now type in ssh pi@10.0.0.2

if it fails:

go to files, this pc, users, your user, then ssh, and delete the file in there.

if it succeeds:

type yes

the password is raspberry

type sudo pwnagotchi --wizard

then say no to restoring a previous config, as there is none

then yes to making a new file

now you get to name your pwnagotchi :D

its going to ask if you want to whitelist your network, if you want to attack your own network then skip this, but if you don't, then say 1 (if you have more than one then type that number) then type in the name of your network.

say no to BT tether

say yes to a display, if you've got the waveshare, say waveshare_4, if you don't know what display you have then click the link.

now choose if you want your pwnagotchi to be black or white

config is done!

Enjoy!

you are now free to unplug your Pwnagotchi, and switch it on. wait a couple minutes for the screen to refresh, and there you have it! Remember to be responsible with this device, don't go attacking networks that aren't yours. once you've attacked a couple networks, you can get the handshake and paste it into a password cracking website.

Check Out This Video If You Are Having Problems

https://www.youtube.com/watch?v=OFxKN3N4gE8

or ask me :)

Shopping List

Get the necessary items here:

Balena Etcher : https://etcher.balena.io/

Jayofelony's Github : https://github.com/jayofelony/pwnagotchi

Windows Driver for Pwnagotchi : https://modclouddownloadprod.blob.cor...

Aluminum Ice's Repo : https://github.com/aluminum-ice/pwnag...

Raspberry Pi Zero W 2 : https://a.co/d/aSJjDAu

Waveshare E-Ink Display : https://a.co/d/64GAt0U


Sources

sources:

https://www.youtube.com/watch?v=R-fTPv09vQ8

https://github.com/evilsocket/pwnagotchi

https://pwnagotchi.ai/intro/

https://www.youtube.com/watch?v=OFxKN3N4gE8

https://pwnagotchi.org/getting-started/configuration/index.html

My Story

Ever since i was young, I've been making things. whether its a trebuchet in the backyard, or a laser tripwire, or even just bristlebots. I've always been very interested in engineering and tinkering. I moved from South Africa to America about two years ago, and its opened so many more opportunities for me. I've been able to get a 3D printer, and start learning CAD using Tinker CAD. I'm always eager to learn more and improve my designs. I've made many more things in America, such as home servers, bitcoin miners, a full chainmail breastplate,(a pwnagotchi) and many more thanks to Instructables.