MCPcopy Index your code
hub / github.com/EFForg/rayhunter

github.com/EFForg/rayhunter @v0.11.2

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.11.2 ↗ · + Follow
669 symbols 1,335 edges 105 files 75 documented · 11%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Rayhunter

Tests

Rayhunter Logo - An Orca taking a bite out of a cellular signal bar

Rayhunter is a project for detecting IMSI catchers, also known as cell-site simulators or stingrays. It was first designed to run on a cheap mobile hotspot called the Orbic RC400L, but thanks to community efforts, it can support some other devices as well. It's also designed to be as easy to install and use as possible, regardless of your level of technical skills, and to minimize false positives.

→ Check out the installation guide to get started.

→ To learn more about the aim of the project, and about IMSI catchers in general, please check out our introductory blog post.

→ For discussion, help, or to join the mattermost channel and get involved with the project and community check out the many ways listed here!

→ To learn more about the project in general check out the Rayhunter Book.

LEGAL DISCLAIMER: Use this program at your own risk. We believe running this program does not currently violate any laws or regulations in the United States. However, we are not responsible for civil or criminal liability resulting from the use of this software. If you are located outside of the US please consult with an attorney in your country to help you assess the legal risks of running this program.

Good Hunting!

Extension points exported contracts — how you extend this code

Analyzer (Interface)
An [Analyzer] represents one type of heuristic for detecting an IMSI Catcher (IC). While maintaining some amount of stat [8 …
lib/src/analysis/analyzer.rs
DeviceConnection (Interface)
Abstraction for device communication (telnet or ADB) [3 implementers]
installer/src/connection.rs
GenericFramebuffer (Interface)
(no doc) [3 implementers]
daemon/src/display/generic_framebuffer.rs
SystemStats (Interface)
(no doc)
daemon/web/src/lib/systemStats.ts
AT (Interface)
(no doc) [1 implementers]
installer/src/pinephone.rs
RuntimeMetadata (Interface)
(no doc)
daemon/web/src/lib/systemStats.ts
DiskStats (Interface)
(no doc)
daemon/web/src/lib/systemStats.ts
MemoryStats (Interface)
(no doc)
daemon/web/src/lib/systemStats.ts

Core symbols most depended-on inside this repo

telnet_send_command
called by 29
installer/src/util.rs
write
called by 18
daemon/src/analysis.rs
parse
called by 17
lib/src/gsmtap_parser.rs
is_empty
called by 14
lib/src/analysis/analyzer.rs
telnet_send_file
called by 14
installer/src/util.rs
decode
called by 14
telcom-parser/src/lib.rs
run_command
called by 12
installer/src/connection.rs
req
called by 11
daemon/web/src/lib/utils.svelte.ts

Shape

Function 302
Method 188
Class 108
Enum 52
Interface 19

Languages

Rust88%
TypeScript10%
Python2%

Modules by API surface

daemon/src/qmdl_store.rs39 symbols
lib/src/diag.rs37 symbols
lib/src/analysis/analyzer.rs31 symbols
daemon/web/src/lib/utils.svelte.ts24 symbols
installer/src/orbic.rs22 symbols
installer/src/lib.rs20 symbols
daemon/src/notifications.rs19 symbols
daemon/src/diag.rs19 symbols
daemon/src/server.rs18 symbols
daemon/web/src/lib/manifest.svelte.ts17 symbols
lib/src/diag_device.rs15 symbols
daemon/src/webdav.rs15 symbols

For agents

$ claude mcp add rayhunter \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact