explaingit

phy1729/rayhunter

Analysis updated 2026-07-17 · repo last pushed 2026-02-15

Audience · generalComplexity · 2/5MaintainedSetup · easy

TLDR

Rayhunter detects cell-site simulators (stingrays) that pretend to be cell towers to spy on your phone. It runs on an affordable mobile hotspot and warns you when surveillance is likely active nearby.

Mindmap

mindmap
  root((rayhunter))
    What it does
      Detects fake cell towers
      Warns about stingray surveillance
      Minimizes false alarms
    Hardware
      Orbic RC400L hotspot
      Community-supported devices
    Use cases
      Journalists on assignment
      Activists at protests
      Privacy-conscious individuals
    Audience
      Non-technical friendly
      No advanced setup needed
    Background
      Built by EFF
      Links to surveillance guide
      Legal disclaimer included

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

What do people build with it?

USE CASE 1

Run it on a mobile hotspot while reporting in the field to get alerted if a stingray is active nearby.

USE CASE 2

Use it at protests or organizing events to detect potential cellular surveillance targeting attendees.

USE CASE 3

Carry it as a personal privacy tool to monitor for fake cell towers in your daily environment.

What is it built with?

RustOrbic RC400L

How does it compare?

phy1729/rayhunter0verflowme/alarm-clock0xhassaan/nn-from-scratch
Stars0
LanguageCSSPython
Last pushed2026-02-152022-10-03
MaintenanceMaintainedDormant
Setup difficultyeasyeasymoderate
Complexity2/52/54/5
Audiencegeneralvibe coderdeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires an Orbic RC400L mobile hotspot or a community-supported device to run.

The license is not specified in the explanation.

In plain English

Rayhunter is a tool that helps you detect when someone is using a cell-site simulator, also known as a "stingray," to spy on your phone's cellular activity. These are devices that pretend to be legitimate cell towers to trick your phone into connecting to them, allowing whoever operates the device to monitor your location, calls, and data. It runs on an affordable mobile hotspot called the Orbic RC400L, and community contributions have expanded support to some other devices as well. The project is designed to be straightforward to install and use, regardless of your technical background. It focuses on minimizing false positives, meaning it aims to alert you only when there is a genuine reason to suspect surveillance rather than crying wolf at normal network activity. This would be useful for journalists, activists, organizers, or anyone concerned they may be targeted by surveillance tools that mimic cell towers. For example, a reporter covering a sensitive story could run this on a personal hotspot to get early warning if a stingray is active in the area. The tool was built by the Electronic Frontier Foundation (EFF), a digital rights organization, which gives it credibility as a privacy-focused project. The README does not go into technical detail on how the detection actually works under the hood, but it links to a broader guide and an introductory blog post for those who want to understand the mechanism and the broader landscape of cellular surveillance. It also includes a legal disclaimer noting that while the EFF believes running the tool does not violate US laws, users outside the US should consult a local attorney to assess any legal risk.

Copy-paste prompts

Prompt 1
How do I install Rayhunter on an Orbic RC400L hotspot and start detecting stingrays?
Prompt 2
What other devices besides the Orbic RC400L are supported by Rayhunter, and how do I set it up on them?
Prompt 3
Help me understand the alerts Rayhunter produces, what should I do if it warns me a cell-site simulator is active?
Prompt 4
What legal risks should I consider before running Rayhunter in my country, and where can I find EFF's guidance on this?

Frequently asked questions

What is rayhunter?

Rayhunter detects cell-site simulators (stingrays) that pretend to be cell towers to spy on your phone. It runs on an affordable mobile hotspot and warns you when surveillance is likely active nearby.

Is rayhunter actively maintained?

Maintained — commit in last 6 months (last push 2026-02-15).

What license does rayhunter use?

The license is not specified in the explanation.

How hard is rayhunter to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is rayhunter for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.