P7-InfraNET CLRadio-Hybrid A-1-ii Integra
Integra is a high-performance, dual-pane terminal communication hub built for real-time "radio" style messaging. It features a split-pane interface powered by Rich and Prompt-Toolkit, allowing users to chat on one side while managing system commands on the other.
🚀 Key Features
- Dual-Pane UI: Dedicated panels for live chat (left) and system commands (right).
- Active Listening: Automatically binds to Port 443 on startup to receive incoming traffic.
- Command Parser: Integrated command-line interface in the "Cmd" panel for profile management and connections.
- Automatic Scrolling: Intelligent log management that slices history to fit your terminal height perfectly.
- Visual Feedback: Active panel highlighting and a blinking cursor to indicate focus.
- Profile Persistence: Saves and loads known peers from
known_connections.txt.
⌨️ Controls & Navigation
| Key | Action |
|---|---|
TAB |
Switch focus between the Chat and Cmd panels. |
ENTER |
Send a message (if in Chat) or execute a command (if in Cmd). |
Ctrl + Q |
Safe Exit: Disconnects sockets and closes the application. |
Backspace |
Standard text deletion in the active panel. |
🛠️ Installation & Setup (Linux/macOS)
Because this app uses specific dependencies and requires privileged ports, follow these steps to ensure a clean environment.
1. Create a Virtual Environment
It is highly recommended to use a venv to avoid library conflicts:
python3 -m venv CLRadio
source CLRadio/bin/activate
2. Install Dependencies
pip install rich prompt-toolkit
3. Running with Sudo (The "Venv" Trick)
Since the app binds to Port 443, it needs root privileges. To use sudo without losing your venv libraries, use the absolute path to the venv's python:
sudo ./CLRadio/bin/python3 CLRadio-Hybrid-A-1-ii-Integra.py
📡 Commands (Cmd Panel Only)
All commands must be typed into the Right Panel and start with a /.
/connect: Displays all saved profiles from yourknown_connections.txt./connect <n>: Attempts to establish a connection to then^{th}profile in your list./profiles add <nickname> <ip>: Saves a new peer to your permanent list./profiles clear: Wipes all saved profiles./listen: Checks the status of the background receiver./help: Displays the in-app command reference.
⚠️ Security Note
Port 443 is a restricted port. Ensure your firewall (ufw/iptables) allows incoming TCP traffic on 443 to receive messages from peers. If running on Windows, ensure you are using an Administrative Terminal.
Developed by P7MJ | P7-InfraNET Architecture