Welcome to the Pwnagotchi community wiki!

The goal of this wiki is to provide as much information as possible to every Pwnagotchi enthusiast - newcomers seeking guidance with building their first Pwnagotchi, as well as the old guard looking for inspiration, or that one line of config they forgot.

Please note, that this wiki is community driven, that means there might be few mistakes. If you spot one, please open an Issue. If you wish to contribute, feel free to do so.

Contributing

Please see here

Getting Started

This section if focused for newcomers, you can find guides such as Building your first Pwnagotchi, that will help you with getting your first device up and running.

Building your first Pwnagotchi

Building your first budget Pwnagotchi by N3ttX - Guide for beginners, that gets you up and running quickly, without any extra hardware (NO SCREEN)

Guide 2 by XYZ (please tag) - Guide about getting your Pwny running on that hardware using this image with those features

Pwnagotchi explained

You can find internal and external resources to different mechanisms that Pwnagotchi utilizes in order to do what it does. You can learn more about 802.11 protocol, 4-way handshakes, little bit about programming languages, machine learning and much more!

Resource 1 by XYZ (if internal, tag, if external, use it's appropriate bibliography) - Learn how WiFi works

Resource 2 by XYZ (if internal, tag, if external, use it's appropriate bibliography) - Learn how you can utilize X in order to exploit Y

Configuration and customization

How to further customize your pwnagotchi using built-in configuration and plugins.

Default configuration

The default configuration explained

Link to the page

Default plugins

Default plugins, what they do, what they are good for, and how to configure them

Link to the page

Plugins

What they are, what they do, how to install them.

Learn more about plugins in this link.

How to install plugins by XYZ (please tag) - Beginner's guide on how to install plugins

How to create your own plugin by XYZ (please tag) - Learn how to utilize Pwnagotchi's event system to create your own plugins

The Plugin Vault - Curated collection of community made plugins, categorized