Home/Projects/

I'm considering switching to Angry Oxide bc this is such a barebones setup either way but thats a question for later <3

Hardware

+-----------------+-------------+----------------------------------------------+
| Component       | Distributor | Details                                      |
+=================+=============+==============================================+
| rpi0w           | Adafruit    | No presoldered GPIO headers (a mistake)      |
+-----------------+-------------+----------------------------------------------+
| microSD Card    | Best Buy    | 64GB (8GB minimum), C10 speed                |
+-----------------+-------------+----------------------------------------------+
| microSD > SD    | rpi400 Kit  | For the regular SD card slot on my laptop    |
+-----------------+-------------+----------------------------------------------+
| battery         | Amazon      | Portable phone charger = >12h battery life*  |
+-----------------+-------------+----------------------------------------------+
| usbA > microUSB | ???         | Data transfer and power capable? they work   |
+-----------------+-------------+----------------------------------------------+
| usbC > microUSB | Ebay        | To power my pi off the phone charger         |
+-----------------+-------------+----------------------------------------------+
| phone           | Apple store | Bluetooth tether bc no screen                |
+-----------------+-------------+----------------------------------------------+
    

* at the low low cost of aesthetics and portability (but it is about as big as the pi itself just thicker)

Crash Course Setup

For detailed docs go to https://pwnagotchi.ai/

Note: I started out with just buying the pi and SD card to make sure everything was working fine before getting other components

1. First you need a pwnagotchi image. I downloaded jayofelony's 32bit image from latest releases
2. No need to extract at this step
3. I used Balena Etcher to write the image to the SD card*
4. After it writes + verifies eject the SD card and plug it into the pi
5. Plug the pi into your laptop (middle port on the pi for data transfer) with a microUSB cable (has to also allow for data transfer)

Windows

6. Wait for the green light to turn on then go to device manager > net adaptors > it should show up under ports (mine was COM7)
7. To connect to the pi over ssh it needs to be registered as an RNDIS ethernet device, so we have to download the drivers
8. I downloaded them from this link: https://modclouddownloadprod.blob.core.windows.net/shared/mod-rndis-driver-windows.zip
9. Extract the file, then go back to device manager > right click on the device > update drivers > select the driver you downloaded
10. Now if you go to control panel > view network status and tasks > change adapter settings you should see an RNDIS ethernet gadget**
11. Usually mine says network cable unplugged or something similar to indicate that it's not fully connected yet so wait until its resolved as an "unidentified network" before doing anything
12. Now we have to configure the IP address
13. Right click on the device > properties > ipv4 > properties > IP 10.0.0.1 subnet 255.255.255.0 dns 8.8.8.8
14. If you use virtualization software like VMs or other ethernet devices make sure they're disabled or IP resolution might not work
15. Now you can try to connect to the pi with `ssh pi@10.0.0.2`, if this doesn't work try can try changing the IP to 10.0.0.2 and gateway to 10.0.0.1, rebooting, etc
16. Almost done! You should get a message on connection with some basic info and commands, now you can use the official pwnagotchi website as a reference for customizing your config

* If you're on windows it's gonna ask you to format the disk because there's "something wrong"; there's nothing wrong it's just a different fs that makes windows mad

** If it's not there try rebooting, changes might not have taken effect yet

Linux

6. Ok I'm tired come back tomorrow

Troubleshooting

Scenario 1: Web UI isn't working

1. `systemctl status pwnagotchi`
2. Check warnings > mine were problems with the config file
3. Whitelisting network names instead of BSSIDs causes resolution issues so just replace those with network BSSID numbers instead
4. To find BSSIDs -> `netsh wlan show interfaces`
5. `systemctl restart pwnagotchi`
6. WebUI should be working @ 10.0.0.2:8080

june 2024