pwnagotchi-plugins

This repo contains my custom plugins for pwnagotchi devices. Much of the work has been developed using the jayofelony image for pwnagotchi. This version does not contain the "AI neural network" features that exist in the evilsocket versions.

If you have enjoyed using these plugins, please help me stay caffeinated by donating to my caffeine fund 😁

Repo Layout:

.
├── agev3.py
├── docs
│   └── images
│       └── agev3.png
├── hashieclean.py
├── README.md
└── stubs
    └── pwnagotchi
        ├── __init__.py
        ├── plugins
        │   └── __init__.py
        └── ui
            ├── __init__.py
            ├── components.py
            ├── fonts.py
            └── view.py

Required for plugin use

You will need to ensure that you have configured the custom_plugins feature in your TOML config file.

    main.custom_plugins = "/usr/local/share/pwnagotchi/custom-plugins/"`

You have two options for installing and using the plugins:

Configure pwnagotchi to use plugins manager feature

• Add the repo

  # ... 
  main.custom_plugin_repos = [
     "https://github.com/IamMrCupp/pwnagotchi-plugins/archive/master.zip",
  ]

• update plugins

  sudo pwnagotchi plugins update

---

agev3.py plugin

This is the age plugin that I am using at the moment due to the lack of calculated Age being displayed while using the jayofelony image. The above image shows the Age feature surrounded by the red squiggly rectangle.

Overview

The plugin determines the Age of the pwnagotchi by crawling over the filesystem and stating a few files. It uses the information harvested off the file creation date and writes out a json blob to be used as the device Birth Date.

Use

• install & enabled plugin

  sudo pwnagotchi plugins install agev3
  sudo pwnagotchi plugins enable agev3
  

• Enable the plugin by adding the following to your config.toml

  main.plugins.agev3.enabled = true
  main.plugins.agev3.age_x_coord = 0
  main.plugins.agev3.age_y_coord = 80
  

• Restart the pwnagotchi app

  pwnkill

---

hashieclean.py plugin

This is a refactored version of the hashieclean plugin to be 100% python 3.11 compatible along with some improvements to error handling/logging and added some validation for required system level tools.

Required Install:

Install hcxpcapngtool using following commands:

git clone https://github.com/ZerBea/hcxtools.git
cd hcxtools
apt-get install libcurl4-openssl-dev libssl-dev zlib1g-dev
make
sudo make install

Overview

This plugin cleans/removed lonely PCAP files; ie. ones that could not be converted to either .22000 (EAPOL) or .16800 (PMKID) formats.

Use

• install & enabled plugin

  sudo pwnagotchi plugins install hashieclean
  sudo pwnagotchi plugins enable hashieclean
  

• Enable the plugin by adding the following to your config.toml

  main.plugins.hashieclean.enabled = true    # true/false
  main.plugins.hashieclean.interval = 12     # in hours
  

• Restart the pwnagotchi app

  pwnkill