Down the Rabbit Hole
Reclaim the Digital Underground
A sovereign, Rust-engineered revival of the golden age of online communitiesโHotline, KDX, BBSes, and AOL. One server, many doors.
The Sovereign Vision
The modern web is a gated ecosystem of surveillance capitalism. Centralized platforms dictate your interactions, profile your behaviors, and monetize your connections.
RabbitHole is a sanctuary for sovereign digital life. Developed under the umbrella of Mirrorward, we build software that bypasses the modern web's watchtowers. We revive the high-trust, cozy communities of the early internetโthe BBS, the dial-up lounge, the pirate serverโand fortify them with modern cryptography, high-performance transports, and decentralization.
At the heart of the system is the **Burrow** (server), which you host. Reachable from modern native apps, command lines, PWAs, telnet clients, and classic Hotline tools.
"Down the rabbit hole: a modern Rust revival of the golden age of online communitiesโone server, many doors."
>_ CORE DESIGN PRINCIPLES
- 01. Sovereignty: No central authority can index, block, or take down your Burrow. You control your server, configuration, and keys.
- 02. Multiplicity: Escape the singular, tracked profiles of today. Create multiple personas on a single account, each with distinct identity keys.
- 03. Verifiable Swarms: Shared files are cryptographically verified chunk-by-chunk using Blake3 event lists and Bao. Fast, resumable P2P downloads.
- 04. Multi-Protocol Gateway: Native QUIC and WebSockets sit side-by-side with Telnet, Finger, NNTP, Hotline, and Icecast radio.
The RabbitHole Architecture
A decentralized network of self-contained Burrows, federated via Tunnels, indexed by Looking Glasses.
The Burrow
The self-contained server node. Written in Rust for maximum speed and safety. Hosts rooms, message boards, file libraries, and wishing wells, secured by Argon2id credentials and a flexible, object-level ACL engine.
Looking Glass
A tracker directory network. Burrows submit signed self-certifying descriptors. Looking Glasses gossip these over a UDP anti-entropy protocol to maintain a verifiable directory of node health.
The Warren
A secure swarm file-sharing layer. Content is identified using Blake3/Bao hashes and distributed P2P. Peers request pieces using a work-stealing scheduler governed by signed capability tokens.
Federated Tunnels
Encrypted Server-to-Server (S2S) links. Administrators exchange Ed25519 public keys to form tunnels. Peered servers sync message boards, route cross-server DMs, and replicate files.
The Looking Glass Directory
Verifiable directory of gossiping Burrows. Inspect descriptors, verify cryptographic keys, and launch console connection.
The Legacy Doors
Yesterday's protocols meet today's speeds. RabbitHole exposes your server across multiple vintage interfaces.
CP437 Art & ZMODEM Transfers
Expose your Burrow to terminal clients. Includes a retro welcome screen, chat rooms, message board readers, and a file libraries browser. Supports ZMODEM file transfer in/out with full resume, and DOOR32 door games (e.g., Legend of the Red Dragon).
- Default Port: 2323
- Feature Gated: telnet_enabled = true
- Supports: ANSI/CP437 rendering
โโโโโโโ โโโโโโ โโโโโโ โโโโโโ โโโ โโโโโโโ
โ โ โ โ โ โ โ โ โ โ โ
โ โโโโโโ โโโ โ โโโ โ โโโ โ โ โโโ โโ
โ โ โ โ โ โ โ โ
โ โ โ โ โ โ โ โ โ โ โ โ
โ โโโโโโ โ โ โ โ โ โ โ โ โ โ โ โ
โโโโโโโโโโโ โโโโโโ โโโโโโ โโโโโโ โโโโโ
-- Welcome to Wonderland --
[C] Chat [B] Boards [F] Files [M] Mail
The Return of Hotline & KDX
Hop on classic Hotline clients (vintage MacOS/Windows) to interact with your modern Burrow. Native support for Hotline accounts, chats, news, and HTXF file transfers with fork-offset resume.
- Default Ports: 5500 (Control) / 5501 (HTXF)
- Feature Gated: hotline_enabled = true
- Client compatibility: Hotline Client v1.23 to v1.9
RFC 1288 Presence Queries
Let anyone check who is online on your Burrow and read public profiles directly from their local shells using the traditional `finger` command.
- Default Port: 7979
- Query: finger alice@wonderland.co
- Outputs: Identity key, online presence, and .plan file
$ finger alice@wonderland.co
Login: alice Name: Alice Liddell
Burrow: wonderland.co Status: Online (Active)
Identity Key: Ed25519: 7d6c...f4a1
Project: Engineering looking-glass gossip network.
Plan:
- Complete cross-burrow flood-fill logic.
- Drink tea with Mad Hatter at 6:00 PM.
Pirate Radio & ICY Delivery
Incorporate a streaming audio station into your Burrow. RabbitHole handles incoming DJ sources via standard protocols and encodes/delivers ICY streams to listeners' audio players.
- Default Ports: 8000 (Stream) / 8001 (Ingest)
- Feature Gated: radio_enabled = true
- Includes: Live metadata updates & web player
Usenet and FTN Integration
Access Burrow message boards via Usenet newsreaders (NNTP) or sync bulletins with FidoNet/binkp networks. Perfect for offline reading and structured mailing list flows.
- Ports: 1119 (NNTP) / 563 (NNTPS) / 24554 (FTN)
- Features: Newsreader support, starttls, FTN nodelists
- Sync format: Signed Blake3 post events
Connecting to news.wonderland.co ...
200 news.wonderland.co RabbitHole NNTP Ready
LIST
215 list of groups follows:
wonderland.lobby 142 1 y
wonderland.announcements 12 1 y
wonderland.wishing-well 54 1 y
.
The Terminal Client
Interact with the RabbitHole network directly from the virtual terminal console below.
Join the Network
Setting up a Burrow or client is straightforward. Reclaim your digital space in minutes.
1. Deploy a Burrow (Server)
Run a sovereign server to host chats, boards, files, wishing wells, and radio. You can compile it from source or spin up a lightweight Docker container.
Minimal Config (burrow.toml)
2. Choose Your Client
Connect to any Burrow using native RHP clients. Use the command line client, TUI dashboards, or install the embedded Leptos PWA from your browser.
Supported Client Surfaces
- โก `rabbit` CLI: Command-line chat, files, and wishing well manager.
- ๐ฅ๏ธ `rabbit-tui`: Beautiful console interface with server uptime graphs.
- ๐ Web App (PWA): Leptos-based web interface served automatically.
- โ๏ธ Telnet / Hotline: Dial in with NetTerm, classic Hotline Client v1.23, or KDX.