ZeroRange

Flipper Zero Training System
Practice. Master. Repeat.

A hands-on training platform to master Flipper Zero capabilities through gamified challenges.
Built on Raspberry Pi with an interactive LCD interface.

▶ Watch on YouTube

📟 LCD Interface Preview

┌────────────────────────────────────┐
│  ╔════════════════════════════╗    │
│  ║ >iButton         25/120   ║    │
│  ║ U/D SEL=Go L=Bk           ║    │
│  ╚════════════════════════════╝    │
│                                    │
│      [▲]                           │
│  [◄] [●] [►]                       │
│      [▼]                           │
└────────────────────────────────────┘

Navigate through challenges using the 5-button interface:

▲ UP / ▼ DOWN - Navigate menus
● SELECT - Confirm selection
◄ LEFT - Go back

Challenges

Currently Available

Module	Challenges	Points	Status
iButton	Touch & Read, Clone, Emulate	30 pts	Available
NFC	Detect, Clone, MIFARE Attack	30 pts	Available
RFID	Detect, Clone, Simulate	30 pts	Available
SubGHZ	Detect Signal, Record & Replay, Signal Analysis	30 pts	Available

Total: 120 points across 12 challenges

Coming Soon

Module	Description	Status
IR	Infrared signal challenges	In Development

Hardware Requirements

Raspberry Pi 5              Components
──────────────              ──────────
GPIO 2 (SDA)  ─────────────► Adafruit LCD (I2C)
GPIO 3 (SCL)  ─────────────►
5V / GND      ─────────────►

USB Port 1    ─────────────► iButton USB Reader (HID)
USB Port 2    ─────────────► Proxmark3 (NFC/RFID)
USB Port 3    ─────────────► HackRF One (SubGHZ)

Components:

Raspberry Pi 5 (or Pi 4)
Adafruit RGB LCD Shield 16x2
iButton USB Reader (HID keyboard emulation)
Proxmark3 (for NFC/RFID challenges)
HackRF One (for SubGHZ challenges)
Flipper Zero (your training tool)

🛒 Shopping List

Affiliate Disclaimer: As an Amazon and AliExpress Associate, I earn from qualifying purchases. You will pay the same price, but I might earn a small commission — this helps finance the gear and support the development of ZeroRange. Thank you!

Component	Amazon	AliExpress
Raspberry Pi 5 (4GB)	Buy on Amazon	—
Adafruit i2c 16x2 RGB LCD Pi Plate	Buy on Amazon	—
Proxmark3	Buy on Amazon	Buy on AliExpress
HackRF One	Buy on Amazon	—
HackRF + Porta Pack	—	Buy on AliExpress
iButton USB Reader	—	Buy on AliExpress

Quick Start

On the Raspberry Pi

# Clone the repository
git clone https://github.com/samxplogs/ZeroRange.git
cd ZeroRange

# Install system dependencies
sudo apt-get update
sudo apt-get install -y python3-pip python3-smbus python3-evdev i2c-tools

# Install Python dependencies
pip3 install -r requirements.txt

# Run ZeroRange
sudo python3 zerorange.py

sudo is required for hardware access (I2C, USB HID, Proxmark3).

Auto-start as a service

sudo bash install_service.sh

This installs a systemd service that automatically starts ZeroRange on boot, including the web interface (port 8000) and LCD API (port 5000).

WiFi Hotspot (optional)

Make ZeroRange fully portable — no existing network required:

sudo bash setup_hotspot.sh
sudo reboot

After reboot, connect to the ZeroRange WiFi network. A captive portal redirects you to the web interface automatically.

Web Interface

Once running, access the web interface at:

http://<RASPBERRY_PI_IP>:8000

The Pi gets its IP via DHCP. Run hostname -I on the Pi to find it. In hotspot mode, the IP is 10.0.0.1.

For detailed installation instructions, see INSTALLATION.md.

Challenge Examples

iButton - Touch & Read

╔════════════════════════════╗
║ Challenge 1               ║
║ Touch & Read              ║
╚════════════════════════════╝
         ↓
╔════════════════════════════╗
║ Waiting for key...        ║
║ Touch to reader           ║
╚════════════════════════════╝
         ↓
╔════════════════════════════╗
║ SUCCESS! +10pts           ║
║ Challenge Done!           ║
╚════════════════════════════╝

NFC - Detect Card

╔════════════════════════════╗
║ NFC Challenge 1           ║
║ Detect any card           ║
╚════════════════════════════╝
         ↓
╔════════════════════════════╗
║ Scanning...               ║
║ Place card on PM3         ║
╚════════════════════════════╝
         ↓
╔════════════════════════════╗
║ FOUND: MIFARE 1K          ║
║ UID: 04:A3:F5:B2          ║
╚════════════════════════════╝

SubGHZ - Record & Replay

╔════════════════════════════╗
║ SubGHz Ch2 [1/2]          ║
║ Press TX button           ║
╚════════════════════════════╝
         ↓
╔════════════════════════════╗
║ Signal captured!          ║
║ Strength: -45dBm          ║
╚════════════════════════════╝
         ↓
╔════════════════════════════╗
║ SOLVED! +10pts            ║
║ Signal replayed!          ║
╚════════════════════════════╝

Features

Gamified Learning - CTF-style challenges with points and progression
Real Hardware - Practice on actual RFID/NFC/iButton systems
Score Tracking - SQLite database tracks your progress
Auto-start - Systemd service for standalone operation
WiFi Hotspot - Connect directly to ZeroRange without network

Project Structure

ZeroRange/
├── zerorange.py          # Main application
├── lcd_manager.py        # LCD display control
├── database.py           # Score persistence
├── config.json           # Configuration
│
├── ibutton_handler.py    # iButton challenge logic
├── nfc_handler.py        # NFC challenges (Proxmark3)
├── rfid_handler.py       # RFID challenges (Proxmark3)
├── proxmark_handler.py   # Proxmark3 interface
├── subghz_handler.py     # SubGHZ challenges (HackRF)
├── hackrf_handler.py     # HackRF One interface
│
├── SUBGHZ_INTEGRATION.md # SubGHZ setup guide
└── docs/                 # Web documentation

Legal Notice

ZeroRange is designed for educational purposes only in a controlled environment.

Only practice on hardware you own or have explicit permission to test. Never use these skills on systems without authorization.

License

This project is licensed under CC BY-NC-SA 4.0 (Creative Commons Attribution-NonCommercial-ShareAlike 4.0).

Attribution - You must give appropriate credit
NonCommercial - No commercial use
ShareAlike - Derivatives must use the same license

See LICENSE for details.

Contributing

Contributions welcome! Please:

Fork the repository
Create a feature branch
Test on real hardware
Submit a pull request

Credits

Created by samxplogs

GitHub: @samxplogs
YouTube: @samxplogs

Built for the Flipper Zero community.

Practice. Master. Repeat.

Name		Name	Last commit message	Last commit date
Latest commit History 14 Commits
challenges		challenges
docs		docs
.gitignore		.gitignore
DEPLOIEMENT_AUTO.md		DEPLOIEMENT_AUTO.md
GPIO5_SETUP.md		GPIO5_SETUP.md
Gemini_Generated_Image_57n5cv57n5cv57n5.png		Gemini_Generated_Image_57n5cv57n5cv57n5.png
HOTSPOT_READY.md		HOTSPOT_READY.md
IBUTTON_IDS.md		IBUTTON_IDS.md
INSTALLATION.md		INSTALLATION.md
LICENSE		LICENSE
NOUVEAUTES_WIFI.md		NOUVEAUTES_WIFI.md
PROJECT_DESCRIPTION.md		PROJECT_DESCRIPTION.md
PROXMARK_INTEGRATION.md		PROXMARK_INTEGRATION.md
QUICK_START.md		QUICK_START.md
README.md		README.md
README_HOTSPOT.md		README_HOTSPOT.md
READY_TO_TEST.md		READY_TO_TEST.md
SUBGHZ_INTEGRATION.md		SUBGHZ_INTEGRATION.md
TEST_GPIO5.md		TEST_GPIO5.md
USB_IBUTTON_INTEGRATION.md		USB_IBUTTON_INTEGRATION.md
WIFI_HOTSPOT.md		WIFI_HOTSPOT.md
WIRING_GPIO5_GPIO6.md		WIRING_GPIO5_GPIO6.md
challenge_loader.py		challenge_loader.py
config.json		config.json
database.py		database.py
debug_hotspot.sh		debug_hotspot.sh
debug_ibutton_events.py		debug_ibutton_events.py
deploy_to_pi.sh.example		deploy_to_pi.sh.example
diagnose_ibutton.py		diagnose_ibutton.py
disable_hotspot.sh		disable_hotspot.sh
flirc_handler.py		flirc_handler.py
gpio_helper.py		gpio_helper.py
hackrf_handler.py		hackrf_handler.py
ibutton_handler.py		ibutton_handler.py
ibutton_usb_reader.py		ibutton_usb_reader.py
install.sh		install.sh
install_service.sh		install_service.sh
ir_handler.py		ir_handler.py
lcd_manager.py		lcd_manager.py
lcd_manager_pi.py		lcd_manager_pi.py
monitor_ibutton_gpio5.py		monitor_ibutton_gpio5.py
nfc_handler.py		nfc_handler.py
proxmark_handler.py		proxmark_handler.py
requirements.txt		requirements.txt
requirements_web.txt		requirements_web.txt
rfid_handler.py		rfid_handler.py
setup_compressed.jpg		setup_compressed.jpg
setup_gpio6_pullup.py		setup_gpio6_pullup.py
setup_gpio6_pullup_v2.py		setup_gpio6_pullup_v2.py
setup_hotspot.sh		setup_hotspot.sh
start_all.sh		start_all.sh
stop_all.sh		stop_all.sh
subghz_handler.py		subghz_handler.py
test_buttons.py		test_buttons.py
test_ibutton_gpio5.py		test_ibutton_gpio5.py
test_usb_ibutton.py		test_usb_ibutton.py
watch_ibutton.sh		watch_ibutton.sh
web_lcd_server.py		web_lcd_server.py
zerorange.py		zerorange.py
zerorange.service		zerorange.service
zerorange_backup.py		zerorange_backup.py

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

ZeroRange

📟 LCD Interface Preview

Challenges

Currently Available

Coming Soon

Hardware Requirements

🛒 Shopping List

Quick Start

On the Raspberry Pi

Auto-start as a service

WiFi Hotspot (optional)

Web Interface

Challenge Examples

iButton - Touch & Read

NFC - Detect Card

SubGHZ - Record & Replay

Features

Project Structure

Legal Notice

License

Contributing

Credits

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

ZeroRange

📟 LCD Interface Preview

Challenges

Currently Available

Coming Soon

Hardware Requirements

🛒 Shopping List

Quick Start

On the Raspberry Pi

Auto-start as a service

WiFi Hotspot (optional)

Web Interface

Challenge Examples

iButton - Touch & Read

NFC - Detect Card

SubGHZ - Record & Replay

Features

Project Structure

Legal Notice

License

Contributing

Credits

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages