🚀 Pwnagotchi Power-Up Plugins

A curated collection of powerful plugins designed to enhance your Pwnagotchi experience. These tools add functionality ranging from remote command execution and automated backups to rich Discord notifications and VPN connectivity.

---

🔌 Universal Installation

1. Download: Click on the .py file you want (e.g., wireguard.py, discord.py) from the file list above.
2. Install: Move the file to your Pwnagotchi's custom plugin directory: /usr/local/share/pwnagotchi/custom-plugins/.
3. Configure: Edit your /etc/pwnagotchi/config.toml file to include the settings listed below.
4. Activate: Restart your Pwnagotchi: sudo systemctl restart pwnagotchi

---

📂 The Plugin Collection

Plugin	Description	Setup Guide
🛡️ AutoBackup	v2.0 - Automated backups with retention policy (garbage collection).	Scroll Down
💾 GitHub_Backups	Automated Git backup script for syncing configs to GitHub/Gitea.	View Guide
🔔 Discord	v3.0.1 - Uploads .pcap files, maps locations, and tracks sessions.	Scroll Down
🔒 Pwny-WG	Connect to home WireGuard VPN and sync handshakes via SSH.	View Guide
🦎 Pwny-Tailscale	Easy Tailscale integration for remote access without port forwarding.	View Guide
📡 TelePwn	v2.0 - Advanced Telegram control and notifications for Pwnagotchi.	View Guide
🌐 web2ssh	Lightweight web interface for executing shell commands from a browser.	Scroll Down
📍 WigleLocator	v2.2 - Queries WiGLE for GPS coordinates and provides live maps.	Scroll Down

---

🛡️ AutoBackup: Your Digital Guardian

(Updated to v2.0 - Now with Garbage Collection!)

The AutoBackup plugin automatically creates compressed .tar.gz backups of your specified files whenever an internet connection is available.

⚙️ Configuration Example:

[main.plugins.auto_backup]
enabled = true
backup_location = "/home/pi/backups"

---

🔔 Discord: The Ultimate Exfiltration Tool

Get instant, beautifully formatted notifications about your Pwnagotchi's conquests via Discord.

⚙️ Configuration Example:

[main.plugins.discord]
enabled = true
webhook_url = "YOUR_DISCORD_WEBHOOK_URL"
wigle_api_key = "ENCODED_API_KEY"

---

🌐 web2ssh: Command Center in Your Browser

Control your Pwnagotchi from anywhere on your network! web2ssh provides a lightweight, password-protected web interface.

🖼️ In Action

---

📍 WigleLocator: Pinpoint Your Pwns (v2.2)

The WigleLocator plugin automatically queries the WiGLE database to find the geographic coordinates for every access point you capture.

⚙️ Configuration Example:

[main.plugins.wiglelocator]
enabled = true
api_key = "ENCODED_API_KEY"