# Dangerous Pi

**Modern web interface for Proxmark3 management on Raspberry Pi Zero 2 W**

Dangerous Pi extends the pi-pm3 project with a sleek cyberpunk-themed web interface, automatic updates, session management, and advanced features designed for [Dangerous Things](https://dangerousthings.com).

## Features

- 🎨 **Cyberpunk UI** - Dark mode default, lightweight, responsive
- ⚡ **FastAPI Backend** - Async Python with SSE for real-time updates
- 🔧 **PM3 Integration** - Uses official Python bindings from iceman fork
- 📱 **Mobile-First** - Works great on phones and tablets
- 🔐 **Session Management** - Single-user with takeover support
- 📊 **Real-time Status** - Live system monitoring and notifications
- 🚀 **Auto Updates** - GitHub releases integration (planned)
- 🔋 **UPS Support** - Battery monitoring and safe shutdown (planned)

## Quick Start

See [GETTING_STARTED.md](GETTING_STARTED.md) for complete setup instructions.

### Development

```bash
# Backend
pip install -r requirements.txt
python -m app.backend.main

# Frontend (in another terminal)
cd app/frontend
npm install
npm run dev
```

Then open http://localhost:3000

### Existing pi-pm3 Features

All you need to do is boot from this image and enjoy using your pm3 over wifi.

This image is configured to set up a wifi access point, and SSH, web bash shell and a web pm3 cli
The default user credentials are - username: `dt` password: `proxmark3`


## usage
You can burn the image to a sd-card using https://etcher.balena.io/   
Insert the sd-card in your RPI Zero 2 w and power it on.   
Wait for one minute for the OS to boot and then connect to the Access Point using the following credentials
```
SSID: raspi-webgui
Password: ChangeMe
```

## AP management interface
Management interface: http://10.3.141.1/

```
IP address: 10.3.141.1
Username: admin
Password: secret
DHCP range: 10.3.141.50 — 10.3.141.254
SSID: raspi-webgui
Password: ChangeMe
```
## web shell
* web shell (u: dt ; p: proxmark3) at http://10.3.141.1:8000/

## web pm3 console
* pm3 shell (u: dt ; p: proxmark3) at http://10.3.141.1:8080/
![pm3shell](images/pm3shell.jpg)

## build

To build new image you should follow the steps below:
(Tested only on Apple Silicon macbook)

1. checkout pi-gen  
    ``` git clone https://github.com/RPi-Distro/pi-gen.git pmbuild ```
2. copy the content of pi-pm3 folder to pmbuild  
    ``` cp -rp pi-gen/* pmbuild/ ```
3. Checkout the arm64 branch of pi-gen  
    ``` cd pmbuild; git checkout arm64 ```
4. make sure you have a docker server running (or any of it's alternatives https://spacelift.io/blog/docker-alternatives)
5. start the build in a docker container   
   ``` ./docker-build.sh ```

On a successful build you should get something like the screenshot blow:
        ![build](images/build.jpg)


# CHANGELOG

* v1.1.0
    - Updated dependencies for debain Trixie.