Skip to content

hak5/wifipineapplepager-themes

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

417 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Themes Library for the WiFi Pineapple Pager by Hak5

Note: This repository is under construction.

This repository contains community-developed themes for the Hak5 WiFi Pineapple Pager.
Themes define the visual appearance, layout, colors, fonts, icons, and UI components used by the device.

Developers and designers are encouraged to submit Pull Requests to add new themes or improve existing ones.

Themes here are written for the official WiFi Pineapple Pager theming system.
Hak5 does NOT guarantee theme compatibility across firmware versions.

See Legal and Disclaimers.


     

                       

Join the community on Hak5 Discord


Table of Contents


Shop

Documentation / Learn More

Community

Got questions or want feedback on your theme?


Additional Links

Follow the creators


About the WiFi Pineapple Pager

A WiFi Pineapple built for hackers who don’t stay put.

The WiFi Pineapple Pager combines the power of Hak5’s PineAP engine with a fast, highly optimized embedded UI. Themes allow creators to reshape the look and feel of the device — from subtle visual refinements to bold, stylized interfaces inspired by retro, tactical, or modern aesthetics.

Themes affect visuals only. They do not alter payload behavior, system configuration, or wireless operations.


About Pager Themes

Pager themes are UI composition and UX behavior definitions, typically composed of:

  • Component layout and composition definitions
  • Icons and Image Assets
  • Color palette

Themes are loaded dynamically by the Pager UI framework and can be switched at runtime.

Themes in this repository are the source assets used directly by the device — no compilation required.


Installing Pager Themes

To install a new theme, simply copy it to /root/themes/, or /mmc/root/themes/ (Create the themes directory if it doesn't exist yet).

Contributing Themes

Once you have created or modified a theme, you are encouraged to contribute it by submitting a Pull Request.

Reviewed and approved Pull Requests will add your theme to this repository, where it may be publicly available to Pager users.

Please ensure your theme:

  • Is tested on real hardware
  • Loads and operates fully without errors
  • Does not rely on undocumented or internal APIs
  • Does not break usability or readability

If your theme is inspired by or based on someone else’s work, credit the original author.


Theme Guidelines

Naming Conventions

  • Each theme must live in its own directory
  • Directory names must be lowercase
  • Use - or _ instead of spaces if required
  • Theme names should be unique, descriptive, and appropriate

Example directory structure:

wargames/
├── assets/
├── components/
├── theme.json
└── README.md

Required Files

Each theme must include:

  • A primary theme definition file, theme.json, in the root of its directory
  • All referenced assets (fonts, icons, images)
  • A README.md containing:
    • Theme name
    • Author
    • Description or inspiration
    • Known limitations
    • Firmware version developed for

A complete list of required component definitions will be added to this README, for now, reference the default theme (wargames) as an example


Design Best Practices

  • Maintain sufficient contrast for readability
  • Ensure UI elements remain usable in outdoor lighting
  • Avoid excessive asset size or visual noise
  • Crop images to the smallest possible size, even when transparent
  • Test with real Pager workflows (alerts, recon, payload execution)

Themes that significantly degrade usability may be rejected.


Prohibited Content

The following will not be accepted:

  • Malicious or deceptive UI intended to mislead users
  • Content that violates Hak5 community standards
  • Copyrighted material without permission
  • Branding that impersonates other products or companies

Legal

Themes from this repository are provided for educational and customization purposes only.

Hak5 gear is intended for authorized auditing and security analysis purposes only where permitted by local and international law. Users are solely responsible for compliance.

WiFi Pineapple and DuckyScript are trademarks of Hak5 LLC.
Copyright © 2010 Hak5 LLC. All rights reserved.

Themes are subject to the Hak5 Software License Agreement:
https://hak5.org/license

Hak5 LLC products and technology are only available to BIS recognized license exception ENC favorable treatment countries pursuant to US 15 CFR Supplement No 3 to Part 740.


Disclaimer

Themes are provided AS-IS without warranty.

While Hak5 makes a best effort to review submitted themes, there is no guarantee of compatibility, performance, or visual correctness across firmware versions or hardware revisions.

Use at your own risk.

About

The Official WiFi Pineapple Pager Theme Repository

Resources

Stars

Watchers

Forks

Contributors