Plugins - V0r-T3x/pwnagotchi-fancygotchi GitHub Wiki
Install additional plugins
Install procedure
For custom plugins to work, you have to add the path to your folder in the config.toml
. I have added these two lines:
main.custom_plugins = "/etc/pwnagotchi/custom-plugins/"
main.custom_plugin_repos = [ "https://github.com/evilsocket/pwnagotchi-plugins-contrib/archive/master.zip",]
depending on where you put your custom-plugins folder in step 3, the procedure onwards is simple:
- copy the plugin_name.py file to your folder (e.g. /etc/pwnagotchi/custom-plugins/)
- add the required settings to the config.toml file. The minimum addition looks like this:
main.plugins.plugin_name.enabled = true
There are several community-developed plugins available, my pwnagotchi has the exp-Plugin by Gaelic Thunder , among others installed.
Example 1 - Install exp plugin
download the plugin.py file from Github.
copy/move plugin file to /etc/pwnagotchi/custom-plugins
.
add the following lines to config.toml
:
main.plugins.exp.enabled = true
main.plugins.exp.lvl_x_coord = 0
main.plugins.exp.lvl_y_coord = 93
main.plugins.exp.exp_x_coord = 38
main.plugins.exp.exp_y_coord = 93
main.plugins.exp.bar_symbols_count = 12
Example 2 - Install hashie plugin
download hashie.py from official git.
copy hashie.py to custom-plugins (see above).
add line in config.toml:
main.plugins.hashie.enabled = true
Infos
-
exp 1.0.5 https://github.com/GaelicThunder/Experience-Plugin-Pwnagotchi
-
webcfg update? https://github.com/dadav/pwnagotchi/blob/master/pwnagotchi/plugins/default/webcfg.py
-
display_version.py 1.0.0 https://github.com/evilsocket/pwnagotchi-plugins-contrib/pull/35/files
-
clock.py 1.0.3 ##changes allow you to customise the displayed time format by editing config.toml, e.g. switching from 12 to 24 hours clock format, or adding seconds https://github.com/evilsocket/pwnagotchi-plugins-contrib/pull/29/files
UI
- Fancygotchi, a complete theme manager for pwnagotchi https://github.com/V0r-T3x/fancygotchi
GPS
-
paw-gps.py 1.0.1 https://github.com/evilsocket/pwnagotchi/pull/1054
-
unoficialGPS 1.0.0 https://github.com/evilsocket/pwnagotchi-plugins-contrib/pull/22/files
Attack
Crack
-
onlinehashcrack 2.1.5 https://github.com/dadav/pwnagotchi-custom-plugins/blob/master/onlinehashcrack.py
-
wpa-sec.py 3.0.2 https://github.com/dadav/pwnagotchi-custom-plugins/blob/master/wpa-sec.py
-
wpa-sec2 #It will only do a check and make .gps.cracked files from the downloaded .cracked.potfile after it downloads from wpa-sec https://github.com/xenDE/pwnagotchi-tools/issues/1
#yml config for it below. NOTE! i didnt test this plugin yet, you need to translate it to toml before you put it in a config
wpa-sec2:
enabled: false
api_key: ''
api_url: "https://wpa-sec.stanev.org"
download_results: true
-
banthex.py a clone of wpa-sec2 https://github.com/V0r-T3x/pwnagotchi_plugins/blob/main/plugins/banthex.py
-
crack_house.py 1.0.0 a plugin to show the nearest cracked AP (based on display_password, act like it if no cracked network at proximity) https://github.com/V0r-T3x/pwnagotchi_plugins/blob/main/plugins/crack_house.py
-
wpa-sec-list 1.0.0 ##List cracked passwords from wpa-sec https://github.com/evilsocket/pwnagotchi-plugins-contrib/pull/34/files
-
hashie.py 1.0.3 ##newer than https://github.com/PwnPeter/pwnagotchi-plugins hashie 1.0.3 //it migh be slower than pwnpeter's version//do more tests// https://github.com/evilsocket/pwnagotchi-plugins-contrib/pull/36/files
Diver
-
home_base 1.0.0 & away_base 1.0.0 https://github.com/troystauffer/home_base plus this fix https://github.com/evilsocket/pwnagotchi/pull/1003
-
HandshakesDL 0.2.2 ##Download handshake captures from web-ui [newer than handshakes 1.0.3 https://github.com/PwnPeter/pwnagotchi-plugins] https://github.com/evilsocket/pwnagotchi-plugins-contrib/pull/27/files
Fixes
-
watchdog.py 1.0.0 https://github.com/dadav/pwnagotchi-custom-plugins/blob/master/watchdog.py
-
fix_region.py 1.0 a plugin to unlock the channel 12 or 13 in certain world region https://github.com/V0r-T3x/pwnagotchi_plugins/blob/main/plugins/fix_region.py
-
screen_refresh 2.0.0 https://github.com/dadav/pwnagotchi-custom-plugins/blob/master/screen_refresh.py
-
auto_update.py 2.0.0 https://github.com/dadav/pwnagotchi-custom-plugins/blob/master/auto_backup.py update it with this: https://github.com/evilsocket/pwnagotchi-plugins-contrib/issues/30