mirror of
https://github.com/smittix/intercept.git
synced 2026-04-25 07:10:00 -07:00
41226d173a
Updated README to improve clarity and structure, including installation instructions and troubleshooting.
148 lines
4.1 KiB
Markdown
148 lines
4.1 KiB
Markdown
# INTERCEPT
|
|
|
|
<p align="center">
|
|
<img src="https://img.shields.io/badge/python-3.9+-blue.svg" alt="Python 3.9+">
|
|
<img src="https://img.shields.io/badge/license-MIT-green.svg" alt="MIT License">
|
|
<img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux-lightgrey.svg" alt="Platform">
|
|
</p>
|
|
|
|
<p align="center">
|
|
<strong>Signal Intelligence Platform</strong><br>
|
|
A web-based interface for software-defined radio tools.
|
|
</p>
|
|
|
|
<p align="center">
|
|
<img src="static/images/screenshots/screenshot_main.png" alt="Screenshot">
|
|
</p>
|
|
|
|
---
|
|
|
|
## Features
|
|
|
|
- **Pager Decoding** - POCSAG/FLEX via rtl_fm + multimon-ng
|
|
- **433MHz Sensors** - Weather stations, TPMS, IoT devices via rtl_433
|
|
- **Aircraft Tracking** - ADS-B via dump1090 with real-time map and radar
|
|
- **Listening Post** - Frequency scanner with audio monitoring
|
|
- **Satellite Tracking** - Pass prediction using TLE data
|
|
- **WiFi Scanning** - Monitor mode reconnaissance via aircrack-ng
|
|
- **Bluetooth Scanning** - Device discovery and tracker detection
|
|
|
|
---
|
|
|
|
## Installation / Debian / Ubuntu / MacOS
|
|
|
|
```
|
|
|
|
**1. Clone and run:**
|
|
```bash
|
|
git clone https://github.com/smittix/intercept.git
|
|
cd intercept
|
|
./setup.sh
|
|
sudo python3 intercept.py
|
|
```
|
|
|
|
### Docker (Alternative)
|
|
|
|
```bash
|
|
git clone https://github.com/smittix/intercept.git
|
|
cd intercept
|
|
docker-compose up -d
|
|
```
|
|
|
|
> **Note:** Docker requires privileged mode for USB SDR access. See `docker-compose.yml` for configuration options.
|
|
|
|
### Open the Interface
|
|
|
|
After starting, open **http://localhost:5050** in your browser.
|
|
|
|
---
|
|
|
|
## Hardware Requirements
|
|
|
|
| Hardware | Purpose | Price |
|
|
|----------|---------|-------|
|
|
| **RTL-SDR** | Required for all SDR features | ~$25-35 |
|
|
| **WiFi adapter** | Must support promiscuous (monitor) mode | ~$20-40 |
|
|
| **Bluetooth adapter** | Device scanning (usually built-in) | - |
|
|
|
|
Most features work with a basic RTL-SDR dongle (RTL2832U + R820T2).
|
|
|
|
---
|
|
|
|
## Troubleshooting
|
|
|
|
### RTL-SDR not detected (Linux)
|
|
|
|
Add udev rules:
|
|
```bash
|
|
sudo bash -c 'cat > /etc/udev/rules.d/20-rtlsdr.rules << EOF
|
|
SUBSYSTEM=="usb", ATTRS{idVendor}=="0bda", ATTRS{idProduct}=="2838", MODE="0666"
|
|
SUBSYSTEM=="usb", ATTRS{idVendor}=="0bda", ATTRS{idProduct}=="2832", MODE="0666"
|
|
EOF'
|
|
sudo udevadm control --reload-rules && sudo udevadm trigger
|
|
```
|
|
Then unplug and replug your RTL-SDR.
|
|
|
|
### "externally-managed-environment" error (Ubuntu 23.04+)
|
|
|
|
The setup script handles this automatically by creating a virtual environment. Run:
|
|
```bash
|
|
./setup.sh
|
|
source venv/bin/activate
|
|
sudo venv/bin/python intercept.py
|
|
```
|
|
|
|
### dump1090 not available (Debian Trixie)
|
|
|
|
On newer Debian versions, dump1090 may not be in repositories. The recommended action is to build from source or use the setup.sh script which will do it for you.
|
|
|
|
|
|
---
|
|
|
|
## Discord Server
|
|
|
|
<p align="center">
|
|
<a href="https://discord.gg/z3g3NJMe">Join our Discord</a>
|
|
</p>
|
|
|
|
---
|
|
|
|
## Documentation
|
|
|
|
- [Usage Guide](docs/USAGE.md) - Detailed instructions for each mode
|
|
- [Hardware Guide](docs/HARDWARE.md) - SDR hardware and advanced setup
|
|
- [Troubleshooting](docs/TROUBLESHOOTING.md) - Common issues and solutions
|
|
|
|
---
|
|
|
|
## Disclaimer
|
|
|
|
This project was developed using AI as a coding partner, combining human direction with AI-assisted implementation. The goal: make Software Defined Radio more accessible by providing a clean, unified interface for common SDR tools.
|
|
|
|
**This software is for educational and authorized testing purposes only.**
|
|
|
|
- Only use with proper authorization
|
|
- Intercepting communications without consent may be illegal
|
|
- You are responsible for compliance with applicable laws
|
|
|
|
---
|
|
|
|
## License
|
|
|
|
MIT License - see [LICENSE](LICENSE)
|
|
|
|
## Author
|
|
|
|
Created by **smittix** - [GitHub](https://github.com/smittix)
|
|
|
|
## Acknowledgments
|
|
|
|
[rtl-sdr](https://osmocom.org/projects/rtl-sdr/wiki) |
|
|
[multimon-ng](https://github.com/EliasOenal/multimon-ng) |
|
|
[rtl_433](https://github.com/merbanan/rtl_433) |
|
|
[dump1090](https://github.com/flightaware/dump1090) |
|
|
[aircrack-ng](https://www.aircrack-ng.org/) |
|
|
[Leaflet.js](https://leafletjs.com/) |
|
|
[Celestrak](https://celestrak.org/)
|
|
|