Stop downloading massive ZIP files. PwnStore is a powerful plugin manager for Pwnagotchi that works both from the command line and through a mobile-friendly web interface. Browse, install, update, and manage plugins surgically—downloading only the files you need.

PwnStore gives you three different interfaces - use whichever fits your workflow:

Perfect for SSH access and automation. The core engine that handles all plugin management.

• Direct terminal control
• Scriptable and automatable
• Full debugging output
• Works via SSH from anywhere

Perfect for mobile users and visual browsing. One-click installs from your phone or desktop browser.

• Access at: http://<your-pwnagotchi-ip>/plugins/pwnstore_ui/
• Touch-optimized interface
• Real-time install/uninstall
• No SSH required

Perfect for browsing and discovering plugins before you install. View the full catalog online.

• Browse at: https://wpa-2.github.io/pwnagotchi-store/
• View all 66+ plugins with descriptions
• Filter by category
• Generate install commands
• No Pwnagotchi connection needed

All three use the same plugin registry - consistent experience everywhere!

*Requires internet to download plugins, but can list already installed ones offline.

• 📦 Lightweight Registry: Queries a remote JSON manifest; doesn't bloat your device
• 🎯 Surgical Installs: Downloads single .py files or extracts specific plugins from archives automatically
• 🧠 Smart Config Hints: Scans plugin code and suggests exact config.toml entries
• ⚡ Auto-Config: Automatically adds enabled = true so plugins load on restart
• 🔄 Self-Updating: Update the tool itself and bulk-upgrade installed plugins
• 🏷️ Auto-Categorized: GPS, Social, Display, Hardware, Attack, System

• 📱 Mobile-Optimized: Touch-friendly interface works perfectly on phones
• 🎨 Retro Terminal Theme: Classic Pwnagotchi green-on-black aesthetic
• ✨ One-Click Installs: No SSH needed - just tap [Install]
• 🔍 Live Search & Filters: Find plugins instantly by name, category, or description
• ✅ Real-Time Status: Installed plugins show green ✓ badge
• 💬 Toast Notifications: Visual feedback for all actions

SSH into your Pwnagotchi and run:

sudo wget -O /usr/local/bin/pwnstore https://raw.githubusercontent.com/wpa-2/pwnagotchi-store/main/pwnstore.py && sudo chmod +x /usr/local/bin/pwnstore

# Download the UI plugin
sudo wget -O /usr/local/share/pwnagotchi/custom-plugins/pwnstore_ui.py https://raw.githubusercontent.com/wpa-2/pwnagotchi-store/main/pwnstore_ui.py

# Enable in config
sudo nano /etc/pwnagotchi/config.toml

Add this line:

main.plugins.pwnstore_ui.enabled = true

Restart Pwnagotchi:

sudo systemctl restart pwnagotchi

Then open in your browser: http://<your-pwnagotchi-ip>/plugins/pwnstore_ui/

Browse available plugins (auto-categorized by GPS, Social, Display, etc.):

pwnstore list
pwnstore search discord
pwnstore sources          # Show repository sources

View author, version, description, and source URL:

pwnstore info <plugin_name>

Downloads, enables, and scans for required settings:

sudo pwnstore install <plugin_name>

Smart Hint: If the plugin requires specific settings (like API keys), PwnStore will print them after installation.

sudo pwnstore update      # Plugin updates
sudo pwnstore upgrade     # Pwnstore upgrades

Removes the file and disables it in config.toml:

sudo pwnstore uninstall <plugin_name>

Access the store at: http://<your-pwnagotchi-ip>/plugins/pwnstore_ui/

From Desktop:

1. Open your browser
2. Navigate to the URL above
3. Browse the plugin gallery
4. Click [Install] on any plugin
5. Wait for success notification
6. Restart Pwnagotchi

From Mobile:

1. Connect to Pwnagotchi's WiFi
2. Open browser (Safari, Chrome, etc.)
3. Visit the plugins page
4. Tap [Install] - optimized for touch
5. Get instant visual feedback
6. No SSH needed! 📱

• 🔍 Live Search: Type to filter plugins instantly
• 🏷️ Category Filters: Display, GPS, Social, Hardware, Attack, System
• ✓ Status Badges: See which plugins are already installed
• ℹ️ Quick Info: Tap info button for plugin details
• 🗑️ One-Click Uninstall: Remove plugins just as easily

Access anywhere: https://wpa-2.github.io/pwnagotchi-store/

This is a public catalog you can browse from any device, even without your Pwnagotchi nearby:

• 📖 Browse all plugins with descriptions and categories
• 🔍 Search and filter by category (Display, GPS, Social, Hardware, Attack, System)
• 📋 Copy install commands - click any plugin to get the command
• 🔗 View GitHub sources - direct links to plugin repositories
• 📱 Access from anywhere - desktop, tablet, phone (no Pwnagotchi needed)

1. Visit wpa-2.github.io/pwnagotchi-store
2. Browse or search for plugins
3. Click on a plugin card to see install command
4. Copy the command (e.g., sudo pwnstore install discord)
5. SSH into your Pwnagotchi and paste the command

Perfect for: Planning your plugin setup, discovering new plugins, or sharing the catalog with others!

┌─────────────────────────────────────────────────────────┐
│              User Interface Layer                       │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  1. CLI Tool (pwnstore)                                 │
│     • Terminal commands                                 │
│     • SSH access required                               │
│     • Direct control                                    │
│                                                         │
│  2. Web UI Plugin (pwnstore_ui.py)                      │
│     • Browser on Pwnagotchi (10.0.0.2/plugins/...)     │
│     • Mobile-friendly, one-click installs               │
│     • Calls CLI tool via subprocess                     │
│                                                         │
│  3. GitHub Pages Gallery                                │
│     • Public catalog (wpa-2.github.io/...)             │
│     • Browse from anywhere                              │
│     • View-only, generates commands                     │
│              ↓                                          │
├─────────────────────────────────────────────────────────┤
│           Core Engine (CLI Tool)                        │
│  • Downloads from GitHub                                │
│  • Manages config.toml                                  │
│  • Scans for dependencies                               │
│  • Validates plugins                                    │
│              ↓                                          │
├─────────────────────────────────────────────────────────┤
│        Remote Registry (plugins.json)                   │
│  • 66+ plugins indexed                                  │
│  • 8 repository sources                                 │
│  • Auto-updated via GitHub Actions                      │
│  • Used by all three interfaces                         │
│                                                         │
└─────────────────────────────────────────────────────────┘

Key Points:

• CLI Tool = The engine (does the actual work)
• Web UI Plugin = Steering wheel (calls CLI tool)
• GitHub Pages = Window shopping (browse only, then use CLI/UI to install)
• All three access the same plugin registry

PwnStore doesn't scan GitHub in real-time (too slow). Instead:

1. The Builder (builder.py): Scans known plugin repositories (listed in repos.txt), categorizes them using keyword logic, and generates a sorted plugins.json

2. The Registry (plugins.json): Hosted in this repository, contains all plugin metadata

3. The Client (CLI/UI): Reads the JSON to perform actions

4. GitHub Actions: Automatically rebuilds the registry when repos.txt is updated

Want to add a plugin to the store?

1. Fork this repository
2. Add the plugin's GitHub URL to repos.txt
3. Submit a Pull Request
4. Wait for merge - the registry will auto-update via GitHub Actions

https://github.com/username/pwnagotchi-plugin-name

Once merged, the plugin will appear in both CLI and Web UI automatically!

• 66+ plugins indexed
• 8 repository sources monitored
• 6 categories: Display, GPS, Social, Hardware, Attack, System
• Auto-updated: Registry rebuilds on every commit

View sources:

pwnstore sources

Output:

REPOSITORY / SOURCE                                | PLUGINS
-----------------------------------------------------------------
github.com/Sniffleupagus/pwnagotchi_plugins        | 22
github.com/NeonLightning/pwny                      | 12
github.com/AlienMajik/pwnagotchi_plugins           | 10
github.com/wpa-2/Pwnagotchi-Plugins                | 7
github.com/unitMeasure/pwn-plugins                 | 7
github.com/jayofelony/pwnagotchi-torch-plugins     | 6
github.com/cyberartemio/wardriver-pwnagotchi-plugin | 1
github.com/marbasec/UPSLite_Plugin_1_3             | 1
-----------------------------------------------------------------
Total Plugins Indexed: 66

pwnstore command not found:

# Reinstall
sudo wget -O /usr/local/bin/pwnstore https://raw.githubusercontent.com/wpa-2/pwnagotchi-store/main/pwnstore.py && sudo chmod +x /usr/local/bin/pwnstore

Install fails:

# Check logs
sudo pwnstore install <plugin> --verbose

# Try manual install
cd /usr/local/share/pwnagotchi/custom-plugins/
wget <plugin-url>

Page won't load:

# Check plugin is enabled
grep pwnstore_ui /etc/pwnagotchi/config.toml

# Check Pwnagotchi is running
sudo systemctl status pwnagotchi

# Check logs
sudo journalctl -u pwnagotchi | grep pwnstore_ui

Install button doesn't work:

# Verify CLI tool is installed
which pwnstore

# Check browser console for errors (F12)

CSRF token errors: The latest version includes CSRF protection - make sure you're running the latest pwnstore_ui.py

Use: Web UI Plugin (/plugins/pwnstore_ui/)

• Browse plugins on your phone while connected to Pwnagotchi
• One-click install without SSH knowledge
• Visual feedback with toast notifications
• Perfect for non-technical users

Use: GitHub Pages Gallery (wpa-2.github.io/pwnagotchi-store)

• Browse plugins from work/home before buying hardware
• Plan your plugin setup in advance
• Share the catalog with friends
• No Pwnagotchi required to explore

Use: CLI Tool (via SSH)

• Script plugin installations
• Automate updates
• SSH from anywhere
• Full control and debugging info

Use: All Three!

• Browse GitHub Pages to see what exists
• Test via CLI for debugging
• Check Web UI for user experience
• Add your plugins to the store via PR

1. Update regularly: sudo pwnstore update to get the latest features
2. Bookmark the UI: Add /plugins/pwnstore_ui/ to your mobile home screen
3. Use CLI for debugging: pwnstore info <plugin> shows full technical details
4. Check sources: pwnstore sources to see where plugins come from
5. Read logs: sudo journalctl -u pwnagotchi -f to watch installations in real-time

• Installation Guide: See above
• Web UI Demo: https://wpa-2.github.io/pwnagotchi-store/
• GitHub Wiki: Coming soon
• Discord Support: Join the Pwnagotchi Discord

• [Discord] - https://discord.gg/PgaU3Vp
• [GitHub Wiki] - https://github.com/jayofelony/pwnagotchi/wiki
• [Reddit] - https://reddit.com/r/pwnagotchi
• [Official Site] - https://pwnagotchi.org
• [Pwnmail Test] - https://opwngrid.xyz/search/a1dcea78603b44e3fc3de09f0b9a0a5e28ffbd2e69429494e0d77bb34a2623ea

If this tool saved you time or saved your SD card from clutter, consider buying me a coffee!

Buy me a coffee (WPA2)

Message me via Pwnmail: Test my Pwnagotchi

This is my test Pwnagotchi - send me a message to test if Pwnmail works or to reach out with feedback, bug reports, or plugin suggestions!

GPL-3.0 License - See LICENSE file for details

Created by WPA2

Special thanks to:

• The Pwnagotchi community
• Plugin developers who make this ecosystem possible
• Contributors who help maintain the registry

• Plugin dependency resolution
• Version pinning support
• Local plugin development mode
• Auto-backup before updates
• Plugin ratings/reviews
• Custom repository support
• Integration with Pwnagotchi updates

Made with 💚 for the Pwnagotchi community