🛰️ TermHub

The Decentralized Terminal Hub - A professional P2P file-sharing platform for developers, built on top of WebTorrent and Nostr.

TermHub allows you to share files and directories directly from your terminal, with a global registry that works at light speed and a 4chan-style dashboard.

🚀 Features

• P2P File Sharing: Share files directly from your machine using BitTorrent/WebTorrent.
• Nostr Identity: Cryptographically verified handles. No central servers, no passwords. Your identity is your private key.
• Background Seeding (Daemon): Keep your files online even after closing the terminal.
• Brutalist Web Dashboard: A high-performance, 4chan-style imageboard to explore and manage your files.
• Git Integration: Push directories while automatically respecting your .gitignore rules.

📦 Installation

npm install -g termhub-p2p

🛠️ Quick Start

1. Set your identity

Choose a unique handle in the decentralized mesh:

termhub name your_awesome_handle

2. Publish a file

Pick any file and share it:

termhub publish my_awesome_project.zip

3. Share a folder (respecting .gitignore)

termhub push

4. Explore the network

Find what others are sharing:

termhub explore
# OR open the web dashboard
termhub ui

5. Keep it online

Start the background daemon to seed all your publications:

termhub daemon start

📜 Commands

| Command | Description | | --- | --- | | publish <file> | Share a single file or directory | | push | Share the current folder (Git-style) | | explore | Interactive P2P registry explorer | | download <magnet> | Download a repository from the network| | ui | Launch the Web Dashboard (localhost:3000) | | name <handle> | Claim your decentralized identity | | status | Show node health and network metrics | | daemon <start\|stop\|status> | Manage background seeding service |

🛠️ Tech Stack

• Engine: Node.js & TypeScript
• P2P: WebTorrent
• Identity & Registry: Nostr (Relay Mesh)
• UI: Vanilla HTML/CSS (Brutalist style)

🤝 Contributing

TermHub is an open-source project. Feel free to open issues and pull requests!

📄 License

ISC