Skip to content

c-nagy/pwnagotchi-educational-purposes-only-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

64 Commits
 
 
 
 

Repository files navigation

Pwnagotchi educational-purposes-only.py Plugin

This plugin allows your Pwnagotchi to detect your home network, pause wifi monitor mode, and associate to the network. It intelligently resumes monitor mode when connection to the home network is lost. <3 pull requests.

Install Dependencies

Nmap and Macchanger must be installed on your Pwnagotchi:


apt update; apt install nmap macchanger

Install and Configure Plugin

  1. While SSH'd in to the Pwnagotchi, create a new folder for third-party Pwnagotchi plugins: mkdir /root/custom_plugins/

  2. Grab the educational-purposes-only.py file from this Github repo and put it into that custom plugins directory.

  3. Edit /etc/pwnagotchi/config.toml and change the main.custom_plugins variable to point to the custom plugins directory you just created: main.custom_plugins = "/root/custom_plugins/"

  4. In the same /etc/pwnagotchi/config.toml file, add the following lines to enable and configure the plugin:


main.plugins.educational-purposes-only.enabled = true
main.plugins.educational-purposes-only.home_network = "Home Network SSID"
main.plugins.educational-purposes-only.home-password = "Home Network Password" # FIXME: use consistent hyphen or underscores in variable names 
main.plugins.educational-purposes-only.minimum-signal-strength = -75  # Minimum accepted RSSI (should be a negative integer)

Reboot the Pwnagotchi to ensure the plugin is initialized.

About

Pwnagotchi plugin to intelligently associate with wireless networks

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages