~= the river <3>

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/.

REC 0:26 Primer acceso. El cliente arranca con su fondo animado de bloques (NEGOCIANDO TOR → TOR LISTO), se pasa la interfaz a español con el botón ES, alice entra con el ID y la clave de un solo uso que le dio el admin y el cliente la obliga a elegir nuevo ID y clave antes de entrar al chat. Al entrar genera su clave de identidad y publica la pública. First access. The client starts over its animated block background (NEGOCIANDO TOR → TOR LISTO), the UI is switched to Spanish with the ES button, alice signs in with the ID and one-time key the admin gave her, and the client makes her pick a new ID and key before entering the chat. On entry it generates her identity key and publishes the public half.
REC 0:21 Consola de administración. 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.
REC 0:20 Sala. alice (izquierda) y bob (derecha) conversan en la sala. alice completa el nombre de bob con Tab y luego recupera su último mensaje con ↑ para corregir la hora antes de reenviarlo. Room. alice (left) and bob (right) chat in the room. alice completes bob's name with Tab, then recalls her last message with ↑ to fix the time before sending it again.
REC 0:16 Privados cifrados de extremo a extremo. alice pide la huella de bob con /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.
REC 0:24 Adjuntos. alice pulsa «Adjuntar», pega la ruta de 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

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.