☄️ VOLOX P2P

The Ultimate Serverless Multiplayer Terminal Dashboard

Volox is a blazing fast, zero-configuration, peer-to-peer (P2P) file transfer and chat engine built entirely for the terminal. It leverages a global Distributed Hash Table (DHT) to punch through NATs and firewalls, connecting multiple computers instantly without any central cloud servers.

🚀 Instant Usage (No Installation Required)

You don't even need to install Volox to use it! Anyone in the world with Node.js can join a Volox room instantly by running:

npx volox-p2p join <room-passphrase>

To start your own room and act as the host, simply install it globally:

npm install -g volox-p2p
volox

✨ Features

• Massive Multiplayer Rooms: Create a room and invite 5, 10, or 50 peers simultaneously. Everyone gets a nickname and is tracked in the real-time "Connected Peers" panel.
• Ghost Sub-Swarms for File Sharing: Share a 2GB folder while chatting with 10 people! Volox instantly spins up background "Sub-Swarms" to stream files to all peers in the room without interrupting the chat.
• Offline / Local Network Mode: No internet? No problem. Volox uses MDNS (Multicast DNS) to automatically discover and connect peers on the same local Wi-Fi or LAN router.
• Interactive Mouse Support: Fully mouse-enabled! Click files in the File Explorer, scroll through the Chat Log, or click the Room Info panel to instantly copy the invite command to your clipboard.
• Zero-Configuration NAT Traversal: No port forwarding required. It uses Holepunching technology to connect you anywhere.

💻 Commands & Chat

Once you are inside the Volox Dashboard, use the chat input box to communicate with the room or execute commands:

• /nick <name> - Customize your display name across the swarm.
• /send <path> - Instantly share a specific file or folder by typing its path.
• /join <room> - Instantly disconnect and hop into another multiplayer room.

🛠️ Built With

• Hyperswarm: For advanced DHT networking, MDNS offline discovery, and Noise-protocol encrypted transport.
• Blessed & Blessed-Contrib: For the stunning, mouse-enabled interactive Terminal UI.
• Tar-FS: For on-the-fly streaming and extraction of entire directory structures.

🔒 Security & Privacy

Volox is fully decentralized. There are no tracking servers, no AWS backends, and no databases. All data transferred over the DHT is encrypted at the transport layer using the cryptographic Noise Protocol (the same technology powering WhatsApp and Signal). You are safe from Man-in-the-Middle (MITM) attacks.

Built with ❤️ for developers who love the terminal.