The River: un chat privado sobre Tor, con estética de BBS. The River: a private chat over Tor, BBS style.
Un proyecto de chat en C++17 que reúne un servidor como servicio oculto de Tor, un cliente gráfico ImGui y una consola de administración. Estas grabaciones muestran el prototipo funcionando en Linux.
A C++17 chat project with a Tor hidden-service server, an ImGui graphical client, and an admin console. These recordings show the prototype running on Linux.
Los mensajes privados y los adjuntos van cifrados de extremo a extremo; el inicio de sesión usa SCRAM, así que el servidor nunca guarda tu contraseña ni nada equivalente.
Private messages and attachments are end-to-end encrypted; login uses SCRAM, so the server never stores your password or anything equivalent to it.
Las demostraciones usan cuentas de prueba y un proxy local para sustituir el trayecto por Tor durante la grabación.
The demos use test accounts and a local proxy in place of the Tor connection while recording.
ILUSTRACIÓNILLUSTRATION Animación hecha en HTML para dar una idea del aspecto. Las grabaciones reales están más abajo. An HTML animation to give an idea of the look. The real recordings are below.
Demo realReal demo
Estos vídeos son grabaciones de pantalla reales de los binarios de The River funcionando: the_river_server, la consola the_river_admin y dos clientes gráficos (alice y bob) en la misma máquina Linux. No hay montajes ni maquetas: solo se recortó la zona de las ventanas y se comprimió el vídeo.
These videos are real screen recordings of The River binaries running: the_river_server, the the_river_admin console and two GUI clients (alice and bob) on the same Linux machine. No mock-ups or edited composites: the capture was only cropped to the windows and compressed.
Cómo se grabó: en una pantalla virtual (Xvfb) con las pulsaciones automatizadas con xdotool, a velocidad de tecleo humana. Para poder grabar sin red, Tor se sustituye por un proxy SOCKS5 local que entrega la conexión al servidor local (con 2 s de espera simulando el circuito); el protocolo, el login SCRAM y el cifrado de extremo a extremo son los de siempre. Cuentas y claves de demostración. Los scripts para reproducirlo están en the_river_cpp/scripts/demo/.
How it was recorded: on a virtual display (Xvfb) with keystrokes automated by xdotool at human typing speed. To record offline, Tor is replaced by a local SOCKS5 proxy that hands the connection to the local server (with a 2 s delay standing in for the circuit); the protocol, SCRAM login and end-to-end encryption are the real ones. Demo accounts and keys only. The scripts that reproduce it live in the_river_cpp/scripts/demo/.
the_river_admin entra por el mismo proxy SOCKS5 (la clave no se muestra al teclear), crea la cuenta de alice con /newuser —el servidor genera una clave inicial aleatoria de un solo uso— y lista las cuentas con /accounts.
Admin console. the_river_admin connects through the same SOCKS5 proxy (the key is not echoed), creates alice's account with /newuser —the server generates a random one-time initial key— and lists accounts with /accounts./fingerprint bob y bob muestra la suya con /fingerprint: coinciden. Después alice escribe /msg bob … y bob contesta con /r …; las líneas [PM] viajan selladas con X25519 + AES-256-GCM y el servidor no puede leerlas.
End-to-end encrypted private messages. alice asks for bob's fingerprint with /fingerprint bob and bob shows his own with /fingerprint: they match. Then alice sends /msg bob … and bob replies with /r …; the [PM] lines travel sealed with X25519 + AES-256-GCM and the server cannot read them.rio.png en el selector de archivos del sistema (zenity) y la oferta [IMG] aparece en la sala. bob hace doble clic, pulsa «Previsualizar» y la imagen llega cifrada de extremo a extremo y se muestra en el cliente. Mientras el selector está abierto, la sesión de alice sigue conectada.
Attachments. alice clicks “Adjuntar” (Attach), pastes the path of rio.png into the system file picker (zenity) and the [IMG] offer shows up in the room. bob double-clicks it, presses “Previsualizar” (Preview) and the image arrives end-to-end encrypted and is shown in the client. alice's session stays connected while the picker is open.Cómo funcionaHow it works
- Servicio oculto de TorTor hidden service
El servidor solo escucha en
127.0.0.1y se publica como.onion. Los clientes llegan por un circuito Tor: nadie ve la IP del servidor ni la tuya. El cliente de escritorio trae Tor incluido. The server listens on127.0.0.1only and is published as a.onion. Clients arrive through a Tor circuit: nobody sees the server's IP or yours. The desktop client ships with Tor bundled. - Login SCRAMSCRAM login Autenticación mutua estilo SCRAM-SHA-256. La base de datos guarda claves derivadas, nunca la contraseña ni un hash que sirva para entrar. Mutual SCRAM-SHA-256 style authentication. The database keeps derived keys, never the password or a hash that could be replayed to log in.
- Privados y adjuntos E2EE2E private messages and attachments
Cada usuario tiene una clave X25519. Los
/msgy los archivos se sellan con AES-256-GCM para el destinatario: el servidor solo reenvía sobres que no puede abrir. Each user has an X25519 key./msgmessages and files are sealed with AES-256-GCM for the recipient: the server only forwards envelopes it cannot open. - Huellas de claveKey fingerprints
Las claves se fijan la primera vez que se ven (TOFU) y el cliente avisa si cambian. Compara
/fingerprintcon tu contacto por otro canal. Keys are pinned on first sight (TOFU) and the client warns when they change. Compare/fingerprintwith your contact over another channel. - Historial y privados offlineHistory and offline PMs Al entrar recibes los últimos 100 mensajes de la sala. Los privados a alguien desconectado quedan en cola (cifrados) hasta 7 días. On login you get the latest 100 room messages. Private messages to someone offline are queued (still encrypted) for up to 7 days.
- Consola de administraciónAdmin console
Crear cuentas, expulsar, banear por usuario o HWID, anuncios y
/whoiscon huella, desdethe_river_admin. Create accounts, kick, ban by user or HWID, announcements and/whoiswith fingerprint, fromthe_river_admin. - Windows / Linux / Termux El código contempla clientes para Windows y Linux x86_64; en Android se compila dentro de Termux y corre en Termux:X11 con una vista compacta. The code includes clients for Windows and Linux x86_64; on Android it builds inside Termux and runs in Termux:X11 with a compact layout.
- Retro a propósitoRetro on purpose Negro, azul BBS, magenta y lima. Comandos con /, historial con ↑/↓, autocompletado con Tab. Interfaz en español o inglés. Black, BBS blue, magenta and lime. Slash commands, ↑/↓ history, Tab completion. Spanish or English interface.
Estado del proyectoProject status
Los vídeos documentan el prototipo del protocolo 2. El código, las pruebas y los cambios en curso se pueden revisar en el pull request. La página de seguridad explica también sus límites.
The videos document the protocol 2 prototype. The code, tests, and ongoing changes are available in the pull request. The security page also explains its limits.
La página de versiones enlaza al último release publicado, que puede ser anterior a lo que se ve aquí.
The versions page links to the latest published release, which may predate what is shown here.