Setup

Step 1 – Install State API Plugin

1. Follow the instructions on how to include community plugins: https://pwnagotchi.ai/plugins/#usage-of-the-communiy-plugins
2. Download state-api.py in your plugins folder.
3. Add this to your config.yml:

  plugins:
    state-api:
      enabled: true

4. Restart your Pwnagotchi

Step 2 – Set up Bluetooth Tethering

Follow the instructions on how to set up bluetooth tethering: https://pwnagotchi.ai/configuration/#bluetooth

Step 3 – Install App on your iPhone

1. Make sure you have at least iOS 13.0 installed.
2. Install TestFlight: https://apps.apple.com/us/app/testflight/id899247664
3. Open this url on your iPhone. You should be forwarded to TestFlight. https://testflight.apple.com/join/r1bhpyDU
4. Accept the invitation and download the app.

Step 4 – App Settings

On iPhone

1. Open the app on your iPhone and tap the »Settings« button.
2. Enter your credentials and make sure that the IP address entered matches the one in the Bluetooth tethering configuration.
3. Go back to the main screen and tap »Connect«

On Apple Watch

1. Open the app on your Apple Watch and force touch the screen. Select the »Settings« menu.
2. Enter your credentials and make sure that the IP address entered matches the one in the Bluetooth tethering configuration.
3. Go back to the main screen and tap »Connect«

Troubleshooting

If the app cannot connect, check if you can open the url http://172.20.10.6:8080/plugins/state-api/json in Safari. If not, the State API is not active or your Pwnagotchi is not connected to Bluetooth.