Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

◈ RayHunter Install Wizard

Interactive step-by-step guide to flash EFF's Rayhunter IMSI catcher detector on an Orbic RC400L hotspot. Auto-detects your OS.

GitHub Pages License: MIT


🚀 Launch the Wizard

👉 Open the Install Wizard


What is Rayhunter?

Rayhunter is the Electronic Frontier Foundation's open-source tool for detecting IMSI catchers (cell-site simulators / stingrays). It runs on an inexpensive Orbic RC400L mobile hotspot (~$15–30 USD) and monitors cellular traffic for signs of surveillance.

This wizard provides a guided, beginner-friendly installation experience for Windows, macOS, and Linux users.

Features

  • Auto-detects your OS — Windows, macOS (ARM & Intel), and Linux (x64, ARM64, ARMv7)
  • Live release picker — fetches the latest Rayhunter releases from GitHub, filtered for your platform
  • 8-step interactive wizard with progress tracking
  • WiFi & USB install methods — toggle between both with OS-specific instructions
  • Copy-to-clipboard commands — one-click copy for all terminal commands
  • Interactive checklists — track your progress through each step
  • Troubleshooting FAQ — OS-specific answers for common issues
  • Fully offline — runs as a single HTML file, no build step or dependencies
  • Mobile-friendly — responsive design works on phones and tablets

Quick Start

Option 1: Use GitHub Pages (recommended)

  1. Fork or clone this repository
  2. Go to Settings → Pages
  3. Set source to Deploy from a branch → main/ (root)
  4. Your wizard is live at your GitHub Pages URL

Option 2: Open locally

Just double-click index.html — it's a single self-contained file with no dependencies.

What You'll Need

Item Details
Orbic RC400L ~$15–30 on eBay/Amazon. Kajeet RC400L also works.
SIM card Any SIM — does not need an active plan.
Computer Windows 10/11, macOS, or Linux with a terminal.
WiFi or USB-C cable WiFi method recommended (no driver setup).

Project Structure

RayHunter-Web-Flasher/
├── index.html          # The complete wizard app (single file)
├── README.md           # This file
├── LICENSE             # MIT License
├── 404.html            # Redirect for bad URLs
└── .nojekyll           # Tells GitHub Pages to skip Jekyll processing

Disclaimer

This is an unofficial companion guide. Rayhunter is developed by the Electronic Frontier Foundation under GPLv3. This wizard does not modify, redistribute, or bundle any Rayhunter software — it only provides installation instructions that link to official EFF releases.

Legal: Use Rayhunter at your own risk. EFF believes running this program does not currently violate any laws or regulations in the United States. Check your local laws.

Links

License

This wizard is released under the MIT License. Rayhunter itself is licensed under GPLv3 by the EFF.

About

Interactive wizard to flash EFF's Rayhunter on Orbic RC400L — auto-detects OS

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages