Versiones y descargasVersions and downloads
El código y las versiones publicadas están en GitHub. Los enlaces de esta página apuntan siempre al último release publicado; cada zip contiene el cliente gráfico y Tor.
The source code and published versions are on GitHub. The links on this page always point to the latest published release; each zip contains the graphical client and Tor.
Antes de probarlo
Before trying it
Los vídeos de la portada muestran el prototipo del protocolo 2. El último release publicado puede ser anterior y no incluir esas funciones. Comprueba la versión en GitHub Releases y usa un cliente del mismo protocolo que el servidor. Las instrucciones de esta página corresponden al protocolo 2.
The homepage videos show the protocol 2 prototype. The latest published release may be older and lack those features. Check its version on GitHub Releases and use a client with the same protocol as the server. The instructions on this page are for protocol 2.
- Windows
- Linux
- Termux (Android)
- ConfiguraciónConfiguration
- Primer accesoFirst login
- CompilarBuild from source
Windows x86_64
the_river_client_windows.zip
Contiene the_river_client.exe y tor_bin/.
Contains the_river_client.exe and tor_bin/.
Linux x86_64
the_river_client_linux.zip
Contiene the_river_client y tor_bin/ con sus librerías.
Contains the_river_client and tor_bin/ with its libraries.
Android (Termux)
Sin binario precompilado: se compila en el dispositivo con los scripts del repositorio.
No prebuilt binary: build it on the device with the repository scripts.
Ver pasosSee stepsWindows
- Descarga
the_river_client_windows.zipy descomprímelo en una carpeta tuya. - Download
the_river_client_windows.zipand extract it into a folder of your own. - Crea
tor_data\runtime.envjunto al ejecutable (ver Configuración). - Create
tor_data\runtime.envnext to the executable (see Configuration). - Ejecuta
the_river_client.exe. El cliente arranca su propio Tor si no hay uno en127.0.0.1:9050. - Run
the_river_client.exe. The client starts its own Tor if none is listening on127.0.0.1:9050.
O todo de una vez en PowerShell:
Or all at once in PowerShell:
New-Item -ItemType Directory -Force -Path "$HOME\TheRiverChat" | Out-Null
cd "$HOME\TheRiverChat"
Invoke-WebRequest -Uri "https://github.com/jhulio435m/the_river/releases/latest/download/the_river_client_windows.zip" -OutFile client.zip
Expand-Archive -Path client.zip -DestinationPath . -Force
New-Item -ItemType Directory -Force -Path tor_data | Out-Null
"THE_RIVER_ONION=<tu-direccion>.onion" | Out-File -FilePath tor_data\runtime.env -Encoding ascii
.\the_river_client.exe
Linux
- Descarga
the_river_client_linux.zipy descomprímelo. - Download
the_river_client_linux.zipand extract it. - Da permisos de ejecución a
the_river_clientytor_bin/tor. - Make
the_river_clientandtor_bin/torexecutable. - Crea
tor_data/runtime.envy ejecuta./the_river_client. - Create
tor_data/runtime.envand run./the_river_client.
mkdir -p ~/TheRiverChat && cd ~/TheRiverChat
wget -L https://github.com/jhulio435m/the_river/releases/latest/download/the_river_client_linux.zip
unzip -o the_river_client_linux.zip
chmod +x the_river_client tor_bin/tor
mkdir -p tor_data
printf 'THE_RIVER_ONION=%s\n' '<tu-direccion>.onion' > tor_data/runtime.env
./the_river_client
Si faltan librerías del sistema, instala GLFW, OpenGL y OpenSSL 3 (en Debian/Ubuntu: libglfw3, libgl1, libssl3).
If system libraries are missing, install GLFW, OpenGL and OpenSSL 3 (on Debian/Ubuntu: libglfw3, libgl1, libssl3).
Termux (Android)
El cliente corre dentro de Termux:X11 con una vista compacta (panel de usuarios plegable, adjuntos con un toque). Necesitas Termux, la app Android Termux:X11 (release nightly oficial), termux-x11-nightly, termux-api y tor.
The client runs inside Termux:X11 with a compact layout (collapsible users panel, one-tap attachments). You need Termux, the Termux:X11 Android app (official nightly release), termux-x11-nightly, termux-api and tor.
pkg install git
git clone https://github.com/jhulio435m/the_river
cd the_river/the_river_cpp
bash scripts/install_termux_dependencies.sh
mkdir -p tor_data
printf 'THE_RIVER_ONION=%s\n' '<tu-direccion>.onion' > tor_data/runtime.env
bash scripts/run_termux_client.sh --rebuild --start-tor
- En Termux el binario no lanza Tor por su cuenta: usa
--start-toro arrancator --SocksPort 9050en otra sesión antes del cliente. - On Termux the binary does not launch Tor itself: pass
--start-toror runtor --SocksPort 9050in another session before the client. - Los archivos se eligen con
termux-storage-gety se abren contermux-open(por eso hace faltatermux-api). - Files are picked with
termux-storage-getand opened withtermux-open(hencetermux-api). - Para recompilar a mano:
bash scripts/build_client_termux.sh. - To rebuild by hand:
bash scripts/build_client_termux.sh.
Configuración del clienteClient configuration
El cliente lee variables de entorno y, si no existen, el primer archivo que encuentre entre tor_data/runtime.env y .env.local (en la carpeta actual o junto al ejecutable). Con protocolo 2 basta con esto:
The client reads environment variables and, failing that, the first file it finds among tor_data/runtime.env and .env.local (in the current folder or next to the executable). With protocol 2 this is all it needs:
# tor_data/runtime.env
THE_RIVER_ONION=<tu-direccion>.onion
Opcional: THE_RIVER_CLIENT_LOG=1 escribe client_runtime.log para diagnóstico (nunca incluye mensajes ni credenciales). Más opciones en la guía.
Optional: THE_RIVER_CLIENT_LOG=1 writes client_runtime.log for troubleshooting (it never contains messages or credentials). More options in the guide.
No publiques la dirección .onion de tu comunidad: compártela solo con quien deba entrar.
Don't publish your community's .onion address: share it only with people who should join.
Primer accesoFirst login
- Espera a que el estado pase de NEGOCIANDO TOR a TOR LISTO. La primera vez Tor puede tardar hasta 2 minutos en construir el circuito.
- Wait for the status to go from NEGOCIANDO TOR to TOR LISTO. The first time, Tor may take up to 2 minutes to build the circuit.
- Entra con el usuario y la contraseña inicial que te dio el administrador (por un canal privado).
- Sign in with the username and initial password your administrator gave you (over a private channel).
- El servidor pide PRIMER ACCESO: elige tu nombre y una contraseña de 12 a 128 caracteres (sin
:). La contraseña nunca sale de tu equipo: solo se envían claves derivadas. - The server asks for a first-login change (PRIMER ACCESO): pick your name and a 12 to 128 character password (no
:). The password never leaves your device: only derived keys are sent. - El cliente crea tu clave de identidad
river_identity_<usuario>.key(cifrada con tu contraseña). Haz copia de seguridad: si la pierdes, se genera otra y tus contactos verán un aviso de cambio de clave. - The client creates your identity key
river_identity_<user>.key(encrypted with your password). Back it up: if you lose it a new one is generated and your contacts will see a key-change warning.
Compilar desde el códigoBuild from source
Necesitas un compilador C++17, CMake, GLFW, OpenGL y OpenSSL 3. En Debian/Ubuntu:
You need a C++17 compiler, CMake, GLFW, OpenGL and OpenSSL 3. On Debian/Ubuntu:
sudo apt-get install -y build-essential cmake libgl1-mesa-dev libglfw3-dev libssl-dev pkg-config
git clone https://github.com/jhulio435m/the_river
cd the_river/the_river_cpp
./build.sh
Produce the_river_server, the_river_client y the_river_admin. Para montar un servidor, sigue la guía del servidor.
It produces the_river_server, the_river_client and the_river_admin. To run a server, follow the server guide.