# Multipurpose Radio Server (MRS)

**Multipurpose Radio Server** is an offline-first connectivity and reconnaissance hub designed for isolated environments.

> Compact communication and information exchange server on Raspberry Pi for service-denied areas. Ideal for disasters, unserviced environments, long-range tracking, and offline-first operations.

## Overview

MRS provides a modular, hardware-focused foundation that interfaces with three supporting layers:

- **MRS Core Layer**: Connectivity, radio, and reconnaissance tools
- **OpenCast Layer**: Media casting, control panel, and remote desktop
- **AI-harness Layer**: AI assistant, knowledge base, and file services

## Core Capabilities

### Connectivity
- 900 MHz HaLow / 2.4 & 5 GHz mesh WiFi via B.A.T.M.A.N.
- LoRa radio communication via Meshtastic node
- QR-code connection setup with captive portal

### Hardware Interface
- Live data visualization to connected TV/display
- Meshtastic LoRa node for field tracking
- Spectrum analysis via SDRAngel

### Reconnaissance & Security
- WiFi/Bluetooth scanning (Bettercap, nmap, masscan)
- Radio frequency recon (SDRAngel)
- ADS-B plane tracking (tar1090)
- Red team toolkit (aircrack, nikto, Metasploit)

## Features

- **Connectivity**: Mesh networking for 1 km+ coverage
- **Archive**: Kiwix offline Wikipedia and knowledge base
- **Recon Tools**: Network and radio frequency scanning suite
- **Messaging**: Federated chat via Synapse/Element (legacy support)
- **Remote Desktop**: VNC integration via OpenCast backend

## Installation

```bash
git clone https://git.zakscode.com/ztimson/mrs
cd mrs
npm ci
```

- MRS core: port 8088
- OpenCast: port 3000
- AI-harness: port 3001

## Documentation

- [Setup Guide](docs/setup.md)
- [Mesh Network](docs/mesh.md)
- [Maps & Geolocation](docs/maps.md)

## Todo

- [ ] API contracts between layers
- [ ] Telemetry endpoint
- [ ] OTA update mechanism

## License

[MIT License](LICENSE).

---

###### By: Zakary Timson
###### Date: September 16, 2025
###### Version: 1.0