Stop downloading massive ZIP files. PwnStore is a lightweight, CLI-based package manager for Pwnagotchi. It allows you to browse, install, update, and manage plugins surgically—downloading only the files you need.
- Lightweight Registry: Queries a remote JSON manifest; doesn't bloat your device.
- Surgical Installs: Downloads single
.pyfiles or extracts specific plugins from large repository archives automatically. - Smart Config Hints: Scans plugin code upon installation and tells you exactly what lines (
self.options) to add to yourconfig.toml. - Auto-Config: Automatically appends
enabled = trueto your config file so the plugin loads on restart. - Self-Updating: The tool can update itself and bulk-upgrade your installed plugins.
- Web Gallery: Includes a retro-themed HTML interface for browsing plugins visually.
SSH into your Pwnagotchi and run this single command to install the store:
sudo wget -O /usr/local/bin/pwnstore https://raw.githubusercontent.com/wpa-2/pwnagotchi-store/main/pwnstore.py && sudo chmod +x /usr/local/bin/pwnstoreBrowse available plugins. The list is auto-categorized (GPS, Social, Display, etc.).
pwnstore list
pwnstore search discordView the author, version, description, and source URL.
pwnstore info <plugin_name>Downloads the plugin, enables it, 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.
Update the PwnStore tool itself, or check all installed plugins for new versions.
# Update the store tool
sudo pwnstore update
# Check for plugin updates
sudo pwnstore upgradeRemoves the file and disables it in config.toml.
sudo pwnstore uninstall <plugin_name>This repository includes a Pwnagotchi-themed Web Gallery (index.html).
If you enable GitHub Pages for this repository, you can browse plugins, filter by category, and generate install commands directly from your browser.
PwnStore does not scan GitHub in real-time (too slow). Instead, it reads a plugins.json registry file hosted in this repository.
- The Builder: A script (
builder.py) scans known plugin repositories (listed inrepos.txt), categorizes them using keyword logic, and generates a sortedplugins.json. - The Client: The
pwnstorescript on your Pwnagotchi reads this JSON to perform actions.
Want to add a plugin to the store?
- Fork this repo.
- Add the GitHub URL of the plugin (or the repo zip archive) to
repos.txt. - Submit a Pull Request.
- Once merged, the registry will auto-update via GitHub Actions.
If this tool saved you time or saved your SD card from clutter, consider buying me a coffee!
