mirror of
https://github.com/smittix/intercept.git
synced 2026-04-24 06:40:00 -07:00
Initial release of INTERCEPT - POCSAG/FLEX pager decoder
Features: - Real-time POCSAG (512/1200/2400) and FLEX decoding - Web-based interface with SpaceX-inspired dark theme - Live message streaming via SSE - Message logging to file - Customizable frequency presets - RTL-SDR device detection and selection - Configurable gain, squelch, and PPM correction 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
James Smith
30
.gitignore
vendored
Normal file
30
.gitignore
vendored
Normal file
@@ -0,0 +1,30 @@
|
||||
# Python
|
||||
__pycache__/
|
||||
*.py[cod]
|
||||
*$py.class
|
||||
*.so
|
||||
.Python
|
||||
env/
|
||||
venv/
|
||||
.venv/
|
||||
ENV/
|
||||
|
||||
# Logs
|
||||
*.log
|
||||
pager_messages.log
|
||||
|
||||
# IDE
|
||||
.idea/
|
||||
.vscode/
|
||||
*.swp
|
||||
*.swo
|
||||
*~
|
||||
|
||||
# OS
|
||||
.DS_Store
|
||||
Thumbs.db
|
||||
|
||||
# Distribution
|
||||
dist/
|
||||
build/
|
||||
*.egg-info/
|
||||
21
LICENSE
Normal file
21
LICENSE
Normal file
@@ -0,0 +1,21 @@
|
||||
MIT License
|
||||
|
||||
Copyright (c) 2025
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
in the Software without restriction, including without limitation the rights
|
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in all
|
||||
copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||
SOFTWARE.
|
||||
172
README.md
Normal file
172
README.md
Normal file
@@ -0,0 +1,172 @@
|
||||
# INTERCEPT
|
||||
|
||||
<p align="center">
|
||||
<img src="https://img.shields.io/badge/python-3.7+-blue.svg" alt="Python 3.7+">
|
||||
<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 // POCSAG & FLEX Pager Decoder</strong>
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
A sleek, modern web-based pager decoder using RTL-SDR and multimon-ng.<br>
|
||||
Decode POCSAG and FLEX pager signals with a futuristic SpaceX-inspired interface.
|
||||
</p>
|
||||
|
||||
---
|
||||
|
||||
## Features
|
||||
|
||||
- **Real-time decoding** of POCSAG (512/1200/2400) and FLEX protocols
|
||||
- **Web-based interface** - no desktop app needed
|
||||
- **Live message streaming** via Server-Sent Events (SSE)
|
||||
- **Message logging** to file with timestamps
|
||||
- **Customizable frequency presets** stored in browser
|
||||
- **RTL-SDR device detection** and selection
|
||||
- **Configurable gain, squelch, and PPM correction**
|
||||
- **Modern dark UI** with SpaceX-inspired aesthetics
|
||||
|
||||
## Screenshots
|
||||
|
||||
The interface features a sleek dark theme with cyan accents, real-time message display, and intuitive controls.
|
||||
|
||||
## Requirements
|
||||
|
||||
### Hardware
|
||||
- RTL-SDR compatible dongle (RTL2832U based)
|
||||
|
||||
### Software
|
||||
- Python 3.7+
|
||||
- Flask
|
||||
- rtl-sdr tools (`rtl_fm`)
|
||||
- multimon-ng
|
||||
|
||||
## Installation
|
||||
|
||||
### 1. Install RTL-SDR tools
|
||||
|
||||
**macOS (Homebrew):**
|
||||
```bash
|
||||
brew install rtl-sdr
|
||||
```
|
||||
|
||||
**Ubuntu/Debian:**
|
||||
```bash
|
||||
sudo apt-get install rtl-sdr
|
||||
```
|
||||
|
||||
**Arch Linux:**
|
||||
```bash
|
||||
sudo pacman -S rtl-sdr
|
||||
```
|
||||
|
||||
### 2. Install multimon-ng
|
||||
|
||||
**macOS (Homebrew):**
|
||||
```bash
|
||||
brew install multimon-ng
|
||||
```
|
||||
|
||||
**Ubuntu/Debian:**
|
||||
```bash
|
||||
sudo apt-get install multimon-ng
|
||||
```
|
||||
|
||||
**From source:**
|
||||
```bash
|
||||
git clone https://github.com/EliasOewortal/multimon-ng.git
|
||||
cd multimon-ng
|
||||
mkdir build && cd build
|
||||
cmake ..
|
||||
make
|
||||
sudo make install
|
||||
```
|
||||
|
||||
### 3. Install Python dependencies
|
||||
|
||||
```bash
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
### 4. Clone and run
|
||||
|
||||
```bash
|
||||
git clone https://github.com/yourusername/intercept.git
|
||||
cd intercept
|
||||
python3 intercept.py
|
||||
```
|
||||
|
||||
Open your browser to `http://localhost:5050`
|
||||
|
||||
## Usage
|
||||
|
||||
1. **Select Device** - Choose your RTL-SDR device from the dropdown
|
||||
2. **Set Frequency** - Enter a frequency in MHz or use a preset
|
||||
3. **Choose Protocols** - Select which protocols to decode (POCSAG/FLEX)
|
||||
4. **Adjust Settings** - Set gain, squelch, and PPM correction as needed
|
||||
5. **Start Decoding** - Click the green "Start Decoding" button
|
||||
6. **View Messages** - Decoded messages appear in real-time in the output panel
|
||||
|
||||
### Frequency Presets
|
||||
|
||||
- Click a preset button to quickly set a frequency
|
||||
- Add custom presets using the input field and "Add" button
|
||||
- Right-click a preset to remove it
|
||||
- Click "Reset to Defaults" to restore default frequencies
|
||||
|
||||
### Message Logging
|
||||
|
||||
Enable logging in the Logging section to save decoded messages to a file. Messages are saved with timestamp, protocol, address, and content.
|
||||
|
||||
## Default Frequencies (UK)
|
||||
|
||||
- **153.350 MHz** - UK pager frequency
|
||||
- **153.025 MHz** - UK pager frequency
|
||||
|
||||
You can customize these presets in the web interface.
|
||||
|
||||
## API Endpoints
|
||||
|
||||
| Endpoint | Method | Description |
|
||||
|----------|--------|-------------|
|
||||
| `/` | GET | Main web interface |
|
||||
| `/devices` | GET | List RTL-SDR devices |
|
||||
| `/start` | POST | Start decoding |
|
||||
| `/stop` | POST | Stop decoding |
|
||||
| `/status` | GET | Get decoder status |
|
||||
| `/stream` | GET | SSE stream for messages |
|
||||
| `/logging` | POST | Toggle message logging |
|
||||
| `/killall` | POST | Kill all decoder processes |
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### No devices found
|
||||
- Ensure your RTL-SDR is plugged in
|
||||
- Check `rtl_test` works from command line
|
||||
- On Linux, you may need to blacklist the DVB-T driver
|
||||
|
||||
### No messages appearing
|
||||
- Verify the frequency is correct for your area
|
||||
- Adjust the gain (try 30-40 dB)
|
||||
- Check that pager services are active in your area
|
||||
- Ensure antenna is connected
|
||||
|
||||
### Device busy error
|
||||
- Click "Kill All Processes" to stop any stale processes
|
||||
- Unplug and replug the RTL-SDR device
|
||||
|
||||
## License
|
||||
|
||||
MIT License - see [LICENSE](LICENSE) for details.
|
||||
|
||||
## Acknowledgments
|
||||
|
||||
- [rtl-sdr](https://osmocom.org/projects/rtl-sdr/wiki) - RTL-SDR drivers
|
||||
- [multimon-ng](https://github.com/EliasOenal/multimon-ng) - Multi-protocol decoder
|
||||
- Inspired by the SpaceX mission control aesthetic
|
||||
|
||||
## Disclaimer
|
||||
|
||||
This software is for educational and authorized use only. Ensure you comply with local laws regarding radio reception and privacy. Intercepting private communications without authorization may be illegal in your jurisdiction.
|
||||
1481
intercept.py
Executable file
1481
intercept.py
Executable file
File diff suppressed because it is too large
Load Diff
1
requirements.txt
Normal file
1
requirements.txt
Normal file
@@ -0,0 +1 @@
|
||||
flask>=2.0.0
|
||||
Reference in New Issue
Block a user