Pwnagotchi Plugins Collection

Author: AlienMajik

Support & Contributions

Feel free to open issues or pull requests to improve this plugin or suggest new features. Enjoy leveling up your Pwnagotchi!

Table of Contents

1. Age Plugin
2. ADSBsniffer Plugin
3. Neurolyzer Plugin
4. ProbeNpwn Plugin
5. SnoopR Plugin
6. SkyHigh Plugin
7. MadHatter Plugin
8. TheyLive Plugin

---

Age Plugin

Version: 4.0.0

Description

A deeply immersive, narrative-driven plugin that transforms your Pwnagotchi into a living cyber-legend. Features prestige rebirth cycles, rich lore messages, cheeky themed quotes (Evil Dead + Monty Python vibes), animated progress, expanded random events with real risk/reward, smarter personality evolution, handshake milestones, and a dedicated status display — all while keeping the UI clean and engaging.

Key Stats

The plugin tracks core statistics that reflect your Pwnagotchi's epic journey:

Age (♥ Age)

• Tracks the number of epochs your Pwnagotchi has lived through.
• Earns flavorful titles like "Baby Steps" (100 epochs), "Neon Spawn" (1,000 epochs), "Data Raider" (10,000 epochs), up to "Intergalactic" (111,111 epochs), and more.
• Titles gain "Reborn" prefix after prestige cycles.

Strength (Str)

• Reflects training progress (now properly accelerated by Time Warp events).
• Titles include "Sparring Novice" (100 train epochs), "Deauth King" (2,000 epochs), "Rev-9" (55,555 epochs), "Kuato" (111,111 epochs), and beyond.
• Also prefixed with "Reborn" after prestige.

Network Points (★ Pts)

• Earn points by capturing handshakes, scaled by encryption strength and prestige multiplier:
• WPA3: +10 base
• WPA2: +5 base
• WEP/WPA: +2 base
• Open/Unknown: +1 base
• Points decay during long inactivity periods to encourage regular use.
• Lifetime total handshakes tracked separately (survives rebirth).

Personality

• Evolves dynamically based on playstyle:
• Aggro: +1 per handshake captured.
• Scholar: +1 every 10 epochs.
• Stealth: +1 every epoch with no handshake (rewards patient, low-visibility sessions).
• Dominant trait displayed on UI if enabled.

New Enhancements in v4.0.0

• Prestige / Rebirth System — Reach max age and max strength titles → trigger rebirth: reset core stats, gain permanent +10% point multiplier per prestige level (1.1×, 1.2×, …). Why better: Adds true end-game progression, replayability, and power fantasy — late-game feels exponentially more rewarding instead of plateauing.
• Rich Narrative Lore Messages — Poetic, atmospheric blurbs for nearly every age/strength title and event (cyberpunk + mythic tone). Why better: Turns dry stat gains into memorable story beats — your Pwnagotchi feels alive.
• Themed Quote Library — Categorized quotes (Ash one-liners for wins, Monty Python absurdity for warnings, insults for failures, ready lines for rebirth). Randomly combined with lore/status. Why better: Injects huge personality, humor, and immersion — status messages are now fun and quotable.
• Dedicated AgeStatus UI Element — New separate line (~y=140) for longer lore/quote/event messages. Why better: Prevents clutter and overwriting of main bettercap status; allows richer storytelling without sacrificing readability.
• Expanded & Balanced Random Events (every ~100 epochs, configurable chance):
• New: Overclock (3× points, 3 handshakes), Hacker's Block (0 points, 3 handshakes), Windfall (+50 instant points), Time Warp (+10% train speed for 100 epochs), Ghost (swap aggro ↔ stealth).
• Existing Lucky Break & Signal Noise kept.
• Events now pull lore + quotes.
• Why better: Much more variety, introduces meaningful risk/reward tension, supports different playstyles (aggressive vs patient), and helps toward rebirth.
• Animated Progress Bar Polish — Switches to > + ~ symbols when >80% to next title (visual "almost there" cue). Why better: Subtle but satisfying feedback that progression is nearing a milestone.
• Smarter Personality Evolution — Stealth now grows on quiet epochs (no handshake). Why better: Rewards stealthy / low-activity sessions instead of being dead weight; personality feels truly responsive.
• Handshake Milestone Achievements — Unlock bonuses at 1, 10, 100, 1,000 handshakes (+50 pts each). Why better: Extra dopamine hits and rewards for consistent capturing.
• Time Warp Persistence & Expiry — Saved/loaded correctly; expires cleanly. Why better: No lost progress on reboots; feels reliable.
• Total Lifetime Handshakes — Survives rebirth (separate from current-cycle count). Why better: Preserves your overall legacy.
• Prestige-Aware Titles & Points Display — Multiplier applied to UI points; "Reborn" prefix. Why better: Instantly shows your ascended status.
• Improved Event & Achievement Messaging — Uses new AgeStatus + quotes/lore. Why better: More immersive announcements.

(Kept & refined from v3.1.0: frequent titles, context-aware dynamic messages, progress bar, streaks (20% bonus at 5+), secret achievements (Night Owl, Crypto King), decay, logging, thread-safe persistence, UI optimization.)

Features

• Persistent Stats — Age, Strength, Points, Personality, Prestige, Achievements, Events survive reboots.
• UI Integration — Clean stats, animated progress, personality (optional), dedicated AgeStatus line.
• Points Logging — /root/network_points.log (timestamp, ESSID, encryption, points).
• Decay Mechanism — Encourages daily/regular use with inactivity penalties.
• Dynamic & Themed Messages — Lore, quotes, face reactions for titles, events, decay, rebirth.
• Prestige Cycles — Reset + permanent multiplier for endless progression.
• Random Events — Spice up gameplay with buffs, debuffs, instant rewards, time acceleration, personality swaps.
• Handshake Streaks & Milestones — Consecutive & total-count bonuses.
• Personality Evolution — Action-based growth; dominant trait shown optionally.
• Secret & Milestone Achievements — Hidden goals + visible count-based unlocks for bonus points.

Installation Instructions

Copy the Plugin File

Place age.py in /usr/local/share/pwnagotchi/custom-plugins/. Or use SCP:

sudo scp age.py root@<pwnagotchi_ip>:/usr/local/share/pwnagotchi/custom-plugins/

Update config.toml

Add to /etc/pwnagotchi/config.toml:

main.plugins.age.enabled = true
main.plugins.age.age_x_coord = 10
main.plugins.age.age_y_coord = 40
main.plugins.age.strength_x_coord = 80
main.plugins.age.strength_y_coord = 40
main.plugins.age.points_x_coord = 10
main.plugins.age.points_y_coord = 60
main.plugins.age.progress_x_coord = 10
main.plugins.age.progress_y_coord = 80
main.plugins.age.personality_x_coord = 10
main.plugins.age.personality_y_coord = 100
main.plugins.age.age_status_x_coord = 10
main.plugins.age.age_status_y_coord = 140          # new
main.plugins.age.show_personality = true
main.plugins.age.decay_interval = 50
main.plugins.age.decay_amount = 10
main.plugins.age.random_event_chance = 0.05        # new, adjustable

Confi.toml bracketed format for Jayofelony image 2.9.5.4:

Add to /etc/pwnagotchi/config.toml:

[main.plugins.age]
age_x_coord = 101
age_y_coord = 80
strength_x_coord = 160
strength_y_coord = 80
points_x_coord = 10
points_y_coord = 60
progress_x_coord = 10
progress_y_coord = 100
personality_x_coord = 10
personality_y_coord = 120
age_status_x_coord = 10
age_status_y_coord = 140
decay_interval = 50
decay_amount = 5
show_personality = false
enabled = true

Restart Pwnagotchi

Apply changes with:

sudo systemctl restart pwnagotchi

Usage

• Monitor Stats — Watch Age, Strength, Points (with prestige multiplier), and progress evolve.
• Capture Handshakes — Build streaks, unlock milestones, earn bonus points.
• Track Progress — Animated bar shows closeness to next title.
• Experience Events — Enjoy (or suffer) random windfalls, overclocks, blocks, time warps, ghosts.
• Develop Personality — Play aggressive or stealthy — trait shifts accordingly.
• Unlock Achievements — Discover secrets and hit count milestones.
• Trigger Rebirth — Max out → transcend, gain permanent power boost.
• Avoid Decay — Stay active to keep points safe.
• Enjoy the Lore — Read narrative blurbs and cheeky quotes on every milestone.

Logs and Data

• Stats Data: /root/age_strength.json
  Stores epochs, train_epochs, points, handshakes (current + lifetime), prestige, personality, achievements, active events, etc.
• Points Log: /root/network_points.log
  Records each handshake with timestamp, ESSID, encryption, points earned.

---

ADSBsniffer Plugin

A plugin that captures ADS-B data from aircraft using RTL-SDR and logs it.

Requirements

A RTL-SDR Dongle is required to run this plugin.

Setup Instructions

1. Connect the RTL-SDR Dongle

First, connect your RTL-SDR dongle to one of the USB ports on your Raspberry Pi (the hardware running Pwnagotchi). Ensure the dongle is properly seated and secure.

2. Access the Pwnagotchi Terminal

To configure the RTL-SDR and test rtl_adsb, you'll need to access the terminal on your Pwnagotchi. You can do this in several ways:

• Directly via Keyboard and Monitor: If you have a monitor and keyboard connected to your Raspberry Pi, you can access the terminal directly.
• SSH: If your Pwnagotchi is connected to your network, you can SSH into it. The default username is usually pi, and the password is raspberry, unless you've changed it. The IP address can be found on the Pwnagotchi screen or through your router's DHCP client list.

3. Install RTL-SDR Drivers and Utilities

Once you're in the terminal, you'll likely need to install the RTL-SDR drivers and the rtl_adsb utility. Pwnagotchi is based on Raspbian, so you can use apt-get to install these packages. Run the following commands:

sudo apt-get install rtl-sdr

4. Verify RTL-SDR Dongle Recognition

After installation, verify that the RTL-SDR dongle is recognized by the system:

rtl_test

This command checks if the RTL-SDR dongle is properly recognized. You should see output indicating the detection of the dongle. If there are errors or the dongle is not detected, ensure it's properly connected or try reconnecting it.

5. Run rtl_adsb

Now, try running rtl_adsb to see if you can receive ADS-B signals:

rtl_adsb

This command starts the ADS-B reception. If your RTL-SDR is set up correctly and there are aircraft in range, you should see ADS-B messages appearing in the terminal.

Installation

Add adsbsniffer.py to /usr/local/share/pwnagotchi/installed-plugins and /usr/local/share/pwnagotchi/available-plugins

In /etc/pwnagotchi/config.toml file add:

main.plugins.adsbsniffer.enabled = true
main.plugins.adsbsniffer.timer = 60
main.plugins.adsbsniffer.aircraft_file = "/root/handshakes/adsb_aircraft.json"
main.plugins.adsbsniffer.adsb_x_coord = 120
main.plugins.adsbsniffer.adsb_y_coord = 50

Disclaimer for ADSBSniffer Plugin

The ADSBSniffer plugin ("the Plugin") is provided for educational and research purposes only. By using the Plugin, you agree to use it in a manner that is ethical, legal, and in compliance with all applicable local, state, federal, and international laws and regulations. The creators, contributors, and distributors of the Plugin are not responsible for any misuse, illegal activity, or damages that may arise from the use of the Plugin.

The Plugin is designed to capture ADS-B data from aircraft using RTL-SDR technology. It is important to understand that interfacing with ADS-B signals, aircraft communications, and related technologies may be regulated by governmental agencies. Users are solely responsible for ensuring their use of the Plugin complies with all relevant aviation and communications regulations.

The information provided by the Plugin is not guaranteed to be accurate, complete, or up-to-date. The Plugin should not be used for navigation, air traffic control, or any other activities where the accuracy and completeness of the information are critical.

The use of the Plugin to interfere with, disrupt, or intercept aircraft communications is strictly prohibited. Respect privacy and safety laws and regulations at all times when using the Plugin.

The creators of the Plugin make no warranties, express or implied, about the suitability, reliability, availability, or accuracy of the information, products, services, or related graphics contained within the Plugin for any purpose. Any reliance you place on such information is therefore strictly at your own risk.

By using the Plugin, you agree to indemnify and hold harmless the creators, contributors, and distributors of the Plugin from and against any and all claims, liabilities, damages, losses, or expenses, including legal fees and costs, arising out of or in any way connected with your access to or use of the Plugin.

This disclaimer is subject to changes and updates. Users are advised to review it periodically.

---

Neurolyzer Plugin

Version: 2.0.0

Overview

The Neurolyzer plugin has evolved into a powerful tool for enhancing the stealth and privacy of your Pwnagotchi. Now at version 2.0.0, it goes beyond simple MAC address randomization to provide a comprehensive suite of features that minimize your device's detectability by network monitoring systems, Wireless Intrusion Detection/Prevention Systems (WIDS/WIPS), and other security measures. By reducing its digital footprint while scanning networks, Neurolyzer ensures your Pwnagotchi operates discreetly and efficiently. This update introduces non-intrusive hardware discovery, dynamic monitor interface preserv