This repository provides an updated guide for setting up and customizing the Pwnagotchi device, a device that passively learns about its surroundings from WiFi traffic. It targets users who want to go beyond the basic installation and integrate specific hardware like Waveshare e-Ink displays and PiSugar power management, or add advanced plugins. The guide aims to resolve issues encountered with newer Pwnagotchi versions and hardware revisions.

How It Works

The guide details the process of flashing a Pwnagotchi image, establishing essential connectivity (SSH, FTP) on Windows, and configuring network settings. It covers enabling Bluetooth tethering for internet access, integrating specific hardware like Waveshare e-Ink displays and PiSugar, and installing additional packages such as aircrack-ng and hcxtools. The guide also explains how to modify configuration files for custom plugins, password changes, and UI settings.

Quick Start & Requirements

• Installation: Flash Pwnagotchi image using Raspberry Pi Imager.
• Prerequisites: Raspberry Pi Zero WH (or Pi Zero 2 W, RPI3, RPI4, RPI5), Waveshare 2.13" V3 e-Ink display (optional), PiSugar 2 (optional), Windows 11 for specific connection steps.
• Setup: Requires flashing an SD card, connecting via USB, and SSH/FTP access. Detailed steps for Windows connectivity are provided.
• Links: Official Pwnagotchi: https://pwnagotchi.org/

Highlighted Details

• Detailed Windows-specific connectivity setup, including RNDIS driver installation and IP configuration.
• Instructions for enabling Bluetooth tethering with specific device configurations.
• Steps for integrating Waveshare 2.13" V3/V4 e-Ink displays and PiSugar 2.
• Guidance on installing and configuring community plugins like aircrack-ng, hcxtools, pySerial, exp, and hashie.

Maintenance & Community

The guide is an update to a previous version, indicating ongoing maintenance and adaptation to changes. It references community discussions and GitHub pull requests for specific fixes and plugin updates.

Licensing & Compatibility

The repository itself is likely under a permissive license given its nature as a guide, but it relies on Pwnagotchi, which is typically MIT licensed. Compatibility is primarily with Raspberry Pi hardware and specific peripherals mentioned.

Limitations & Caveats

The guide notes that some bugs are still unresolved, particularly concerning bettercap signal display and startup issues when onlinehashcrack or wpa-sec plugins are enabled. It also mentions that the official Pwnagotchi installation guide is outdated, necessitating this community-driven approach. Some installation steps, like building hcxtools, can be time-consuming.