Step 4 Customization

Customizing your Pwnagotchi

You might want to customize your Pwnagotchi to make it more personal. You can do this by changing the theme, adding plugins, or even creating your own plugins.

PwnDroid

This is an Android app that allows you to share your phone's GPS with 1 or more Pwnagotchi. To install the plugin run the following command:

Installing the plugin can be done by running:

sudo pwnagotchi plugins update
sudo pwnagotchi plugins install pwndroid

Upgrading the plugin can be done by running:

sudo pwnagotchi plugins update
sudo pwnagotchi plugins upgrade pwndroid

Configuration

main.plugins.pwndroid.enabled = true
main.plugins.pwndroid.display = false # show coords on display
main.plugins.pwndroid.display_altitude = false # show altitude on display

BT-Tethering

If you want to use your Pwnagotchi on the go, you can use a Bluetooth tethering connection. This way you can connect to the internet without needing a Wi-Fi connection. To do this enter the following commands while connected over SSH:

sudo bluetoothctl
scan on
# Wait for your phone to show up
pair <Your phone's MAC address>
trust <Your phone's MAC address>

Now you can enter the details into the configuration file config.toml under the main.plugins.bt-tether section. And enable the plugin by setting enabled = true. Either reboot the Pwnagotchi or restart the service using pwnkill.

main.plugins.bt-tether.enabled = true
main.plugins.bt-tether.phone-name = "" # Your phone's name
main.plugins.bt-tether.phone = "" # android or ios
main.plugins.bt-tether.mac = "" # your phone's MAC address
main.plugins.bt-tether.ip = "" # 192.168.44.2-254 for android, 172.20.10.2-254 for ios
main.plugins.bt-tether.prefer-bluetooth = false # optional, set to "true" to prefer Bluetooth tethering, set to "false" to prefer USB tethering

PiSugarX

Be sure to read their documentation before you start, so you know the basics about PiSugar.

Power Manager is no longer needed to make the plugin work, you can optionally install it to manage your battery.

Previous: Configuration