init

README.md

@@ -0,0 +1,83 @@
+# Multipurpose Radio Server (MRS)
+
+---
+
+###### By: Zakary Timson
+###### Date: September 16, 2025
+###### Version: 1.0
+
+---
+
+![](https://meshtastic.org/assets/images/lora-topology-2-c80684f1eafdf2a71fbaf26e494fb26d.webp)
+
+> 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.
+
+---
+
+## Table of Contents
+- [Multipurpose Radio Server](#multipurpose-radio-server-mrs)
+    - [Description](#description)
+        - [Inspiration](#inspiration)
+        - [Capabilities](#capabilities)
+    - [Manual](#manual)
+        - [Setup](docs/setup.md)
+        - [Introduction](#introduction) <!-- Home + Settings page -->
+        - [Connecting & Wifi](#connecting)
+        - [Mesh Network](#mesh-network)
+        - [LoRa Radio](#lora-radio)
+        - [FileBrowser](#filebrowser)
+        - [Desktop Environment](#desktop-environment)
+        - Services
+            - [AI Assistant](#ai-assistant)
+            - [Archive](#archive)
+            - [ATAK](#atak)
+            - [Maps](docs/maps.md)
+            - [Messaging](#messaging)
+            - [Pentesting](#pentesting)
+            - [SDR](#sdr)
+            - [SSH](#ssh)
+            - [VPN](#vpn)
+    - [Todo](#todo)
+    - [License](LICENSE)
+
+---
+
+## Description
+
+### Inspiration
+- [A.C.I.D](https://www.youtube.com/watch?v=nSrYmkGq9TM)
+- [Offline internet](https://www.youtube.com/watch?v=L5RJZmuRJKA)
+- [Meshtastic radios](https://morosx.com/ols/products/xtak-lora-mesh)
+- [HaLow mesh network](https://www.youtube.com/watch?v=ofR7GFNZzJY)
+- [Signal Intelligence](https://www.youtube.com/watch?v=Nam87B2u6bo&t=1942s)
+
+### Capabilities
+
+**Networking**
+- 900 MHz **HaLow** / 2.4 GHz / 5 GHz Mesh WiFi using **B.A.T.M.A.N.** (1 km +)
+- LoRa radio communication (1-100s of kms)
+- Connect to AP with QR code using **dnsmasq, hostapd** 
+- Captive portal & device home page + settings page
+
+**Communication**
+- Offline & federated text/voice/file chat using **Synapse** and **Element**
+- Built-in LoRa **Meshtastic** node (≈2–15 km)
+- GPS positioning & offline maps using **gpsd, chrony**
+- Track people & logistics with **ATAK**
+
+**Information Archive**
+- Offline AI/LLM assistant using **Ollama** and **OpenWebUI**
+- Offline Wikipedia, Ghetesburg project & more using **Kiwix**
+- File sharing & syncing using **FileBrowser** and **Rclone**
+- Remote desktop usig **RDP** and **Apache Guacamole**
+
+**Recon & Security**
+- WiFi & Bluetooth reconnaissance with **Bettercap, nmap, masscan** and more
+- Red team operations with **aircrack, nikto, Metasploit** and more
+- Radio frequency recon using **SDRAngel**
+- ADS-B plane tracking with **tar1090**
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).