🛒 PwnStore - The Unofficial Pwnagotchi App Store

Stop downloading massive ZIP files. Install Pwnagotchi plugins surgically—one file at a time.

---

🚀 Quick Install

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

Then browse and install plugins:

pwnstore list              # Browse 70+ plugins
sudo pwnstore install <plugin_name>

---

📦 Four Ways to Use PwnStore

Interface	Perfect For	Access
🖥️ CLI Tool	SSH users & automation	pwnstore list
🌐 Web UI	Mobile users, one-click installs	http://<ip>/plugins/pwnstore_ui/
🌍 Gallery	Browsing & discovering plugins	pwnstore.org
🛠️ Troubleshooter	Fixing problems step-by-step	pwnstore.org/troubleshoot

---

📚 Documentation

Getting Started:

• 📖 CLI Guide - Commands and usage
• 🌐 Web UI Guide - Browser interface setup
• 🛠️ Troubleshooting - Fix common issues
• ❓ FAQ - Quick answers

Contributing:

• 🤝 Add Your Plugin - Submit to the store

---

✨ Features

• 📦 Lightweight: No massive ZIP files—download only what you need
• 🎯 Surgical Installs: Single .py files or auto-extracted from archives
• 🧠 Smart Config: Automatically adds enabled = true to config.toml
• 🔄 Auto-Update: Keep plugins and PwnStore itself up to date
• 📱 Mobile-Friendly: Touch-optimized web interface
• 🏷️ Auto-Categorized: GPS, Social, Display, Hardware, Attack, System

---

💡 Need Help?

🛠️ Interactive Troubleshooter

Can't connect? Display not working? Plugin issues?
👉 pwnstore.org/troubleshoot.html

Step-by-step wizard with click-to-copy commands. Works on any device!

💬 Community Support

• Discord - Get help from the community
• Telegram - UK Pwnagotchi chat
• Reddit - r/pwnagotchi
• Wiki - Official docs

---

📊 Quick Stats

• 70+ plugins indexed and ready to install
• 8 repository sources automatically monitored
• 6 categories for easy discovery
• Auto-updated registry via GitHub Actions

pwnstore sources    # View all plugin sources

---

☕ Support the Project

If PwnStore saved you time or SD card space, consider buying me a coffee!

☕ buymeacoffee.com/wpa2

---

📜 License

GPL-3.0 License - See LICENSE file for details

Made with 💚 for the Pwnagotchi community by WPA2

---

🔗 Quick Links

• 🌐 Plugin Gallery: pwnstore.org
• 🛠️ Troubleshooter: pwnstore.org/troubleshoot.html
• 💬 Discord: discord.gg/jFasAGdTFm
• 📱 Telegram: t.me/Pwnagotchi_UK_Chat
• 📖 Documentation: docs/