Pwnagotchi Basic Instructions

Hello and thanks for your order!

This guide will go over powering on your device, Installing the driver to SSH into your device, and let you know where your handshakes are that you capture. There is tons of videos on YouTube for customizing your device and I actually have a few that you can find in the how to guides on this website.

Turning it on

To power on the device, you will need to supply your own power via USB. plug the device into power, using the far right port. Once you see the green light, give it 2 to 3 minutes to boot up



Different Modes


AUTO

This is the default mode your unit will start if only connected to the USB power port, for instance when connected to a powerbank without any host computer on the data port. In AUTO mode, your unit will start operating, perform attacks and sniffing handshakes

AI

AUTO mode will transition to AI mode after a few minutes (on average, about 10-15 minutes). This interval is required to load all the dependencies the AI module will be using and initialize the neural network. You can think about this as your Pwnagotchi waking up :D Once the dependencies are loaded and so the /root/brain.nn file, AI mode will pick the optimal set of parameters in real time, depending on how long it’s been trained on the specific type of WiFi environment it’s observing now.

MANU

If connected to the USB data port of your computer (or a tablet, phone, etc), your Pwnagotchi will start in MANUAL mode. This means it will read the log of the last session and report a few statistics on the screen. This is the mode you should be using your unit when you want to transfer data from/to it. Moreover, in MANU mode, you’ll be able to access bettercap’s web UI from your computer by pointing your browser to http://pwnagotchi.local.

 

What The Screen Means


Connecting To The Pwnagotchi


you will need a driver on your computer and an SSH client. Link to both are below.

    • RNDIS Driver - Network driver for Pwnagotchi
    • Termius - SSH Client (you can use the built in one too)
  1. Download the driver and unzip it. Plug in the device to your computer using the inner DATA port. Open “Device Manager” and find com ports. You should see a new com port. Right click the new com port and go to properties, install driver, have disk, select the INF in the unzipped driver folder. You should see a new network adapter on your computer. This is how you talk to the Pwnagotchi! I know this part can be confusing but I have a video on my YouTube channel on how to add custom faces that goes over the SSH process. You can see that for a video walk through. Video here
  2. If your Pwnagotchi has already been booted up at least once before: after a few seconds, you will see a new Ethernet interface on your host computer.
  3. You’ll need to configure it with a static IP address:
    • IP: 10.0.0.1
    • Netmask: 255.255.255.0
    • Gateway: 10.0.0.1
    • DNS (if required): 8.8.8.8 (or whatever)
  4. If everything’s been configured properly, you will now be able to ping 10.0.0.2
    • Congratulations! You should now be able to connect to your unit using SSH:

     

    Lastly, your Handshakes will be in /root/handshakes directory of your Pwnagotchi. You can SFTP using Termius into your Pwnagotchi and go to that folder to extract the handshakes to your computer. What you do with them is your business ;)