gitwtfhub

wtf is purplx-?

purplxhazee/purplx- — explained in plain English

Analysis updated 2026-05-18

11C++Audience · generalComplexity · 2/5Setup · moderate

TL;DR

A cyberpunk themed operating system for the M5Stack Cardputer ADV handheld device, packed with games, offline survival guides, and a WiFi presence radar.

Mindmap

mindmap
  root((Purplx))
    What it does
      Cyberpunk device OS
      Ten built in games
      Offline survival library
    Tech stack
      Cplusplus
      ESP32-S3 chip
    Use cases
      Play games offline
      Learn survival skills
      Sense nearby people
    Hardware
      Cardputer ADV
      Optional second screen
      SD card for extras
    Audience
      Cyberdeck hobbyists

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Play ten built in games like Chess, Snake, Tetris, and an original roguelike on a handheld device.

REASON 2

Access offline survival guides for first aid, water, fire, knots, signaling, and navigation with no internet needed.

REASON 3

Detect nearby human movement using WiFi signal disruption, with no camera or microphone involved.

REASON 4

Raise a virtual pet that ages and needs care in real time, even while the device is off.

What's in the stack?

C++ESP32-S3

How it stacks up

purplxhazee/purplx-youtalk/create_autonomyzartbot/gfd
Stars111111
LanguageC++C++C++
Last pushed2020-10-14
MaintenanceDormant
Setup difficultymoderatehardhard
Complexity2/54/55/5
Audiencegeneralresearcherresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires an M5Stack Cardputer ADV device and a USB-C cable for flashing, an SD card and second screen are optional.

Wtf does this do

Purplx is custom firmware that turns an M5Stack Cardputer ADV, a small handheld device built around an ESP32-S3 chip, into a self contained little computer with a cyberpunk theme. The README is clear that this is not a hacking tool, it is more like a full operating system packed with games, survival information, everyday utilities, and a way to launch other firmware without losing your place. It supports an optional second screen wired in alongside the device's built in display, so bigger apps get a proper screen while a smaller panel keeps showing quick status details. Ten playable games are built in, including Snake, Tetris, Chess, Checkers, Pong, 2048, Wordle, Conway's Game of Life, and an original roguelike called Netrun with procedural levels and permanent death. There is also a tamagotchi style virtual pet that keeps getting hungry, bored, and tired over real time, even while the device is switched off. For situations without internet or phone signal, Purplx stores an offline survival guide covering first aid, finding water, starting fires, useful knots, signaling for rescue, and navigating without GPS, all built into the firmware itself. It also includes a Morse code trainer that can transmit messages using the screen's backlight and speaker, a continuous SOS beacon, and a short library of plain English lessons explaining how WiFi and Bluetooth attacks work along with the legal ways to practice them, like bug bounties and competitions. A standout feature is a WiFi based radar that can sense a person's presence by watching how ambient WiFi signals get disrupted as they move nearby, using no camera or microphone at all. Rounding things out are everyday tools like a clock, flashlight, dice roller, calculator, unit converter, a simple notes app, and a music player for WAV files stored on an SD card. Purplx is written in C++ for the ESP32-S3 platform. To use it you flash it onto a Cardputer ADV over USB-C, and an SD card is recommended for notes and music but is not required for most features to work.

Yoink these prompts

Prompt 1
Explain how to flash Purplx onto an M5Stack Cardputer ADV.
Prompt 2
Walk me through wiring an optional ILI9341 display to the Cardputer ADV for Purplx.
Prompt 3
Explain how the WiFi CSI radar feature in Purplx detects human presence.
Prompt 4
Show me how the Netrun roguelike game works in Purplx.

Frequently asked questions

wtf is purplx-?

A cyberpunk themed operating system for the M5Stack Cardputer ADV handheld device, packed with games, offline survival guides, and a WiFi presence radar.

What language is purplx- written in?

Mainly C++. The stack also includes C++, ESP32-S3.

How hard is purplx- to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is purplx- for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.