Triple puente matrix-telegram-deltachat
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-10-07 18:14:29 +02:00
bridge_app fix discord 2026-10-07 18:14:29 +02:00
tests fix discord 2026-10-07 18:14:29 +02:00
.env copy xmpp 2026-10-07 17:34:49 +02:00
.env.example Merge branch 'main' of https://git.emancipacio.com/reaver/El-Ca-Cerber 2026-10-07 17:35:14 +02:00
.gitignore Add multi bridge 2026-10-07 16:27:39 +02:00
bridge.py push 2026-10-02 12:02:00 +02:00
bridges.example.yml xmpp 2026-10-07 17:34:49 +02:00
bridges.yml xmpp 2026-10-07 17:34:49 +02:00
LICENSE push 2026-10-02 12:02:00 +02:00
PRIVACIDAD_TELEGRAM.md push 2026-10-02 12:02:00 +02:00
README.md merge 2026-10-07 17:55:32 +02:00
requirements.txt Merge branch 'main' of https://git.emancipacio.com/reaver/El-Ca-Cerber 2026-10-07 17:35:14 +02:00

Descripción de la imagen

Puente Telegram - Discord - Delta Chat - Matrix - XMPP

Bot en Python que reenvía mensajes entre puentes formados por chats de Delta Chat, canales de Discord, chats de Telegram, salas de Matrix/Element y salas MUC XMPP. Cada mensaje se envía solo a las otras plataformas del puente de origen. Usa cuentas dedicadas; los mensajes no se traducen. Los mensajes reenviados se identifican con un emoji por hablante (por ejemplo, 🟠 Reaver @ delta ➤); la asignación se conserva entre reinicios y recorre una paleta amplia de emojis variados antes de volver a empezar.

Se reenvían fotos, vídeos, audio, notas de voz y archivos de hasta 50 MB (50.000.000 bytes). Discord reenvía adjuntos como archivos y stickers como archivos de imagen; los stickers animados Lottie en formato JSON se sustituyen por el emoji 🎭. No crea stickers nativos de Discord. Si un adjunto supera ese tamaño, no se transfiere y se envía un aviso con su formato y tamaño. El Bot API estándar de Telegram limita la descarga de archivos a 20 MB; por eso, un adjunto entrante de Telegram mayor de 20 MB no se puede descargar aunque no supere el límite del puente. Discord puede aplicar límites de subida menores según el servidor o la cuenta. XMPP reenvía archivos de hasta 50 MB mediante HTTP File Upload (XEP-0363), compartición de archivos (XEP-0447) y el formato OOB (XEP-0066) para mejorar la compatibilidad con clientes antiguos. El servidor y la sala deben permitir esas extensiones; las descargas multimedia entrantes requieren una URL HTTPS pública y admiten redirecciones HTTPS. Los stickers estáticos WebP se envían como stickers nativos a Delta Chat y Matrix. Los stickers animados .tgs se envían como archivos y los stickers de vídeo .webm como vídeos, porque no son stickers WebP estáticos.

Preparación

Requiere Python 3.11 o posterior. La dependencia E2E necesita libolm y sus cabeceras de desarrollo instaladas en el sistema. En este entorno ya están disponibles. Instala las dependencias Python con:

GNU:

python -m venv .venv
source .venv/bin/activate
CMAKE_POLICY_VERSION_MINIMUM=3.5 pip install -r requirements.txt
cp .env.example .env

Android:

python -m venv .venv
source .venv/bin/activate

mkdir -p "$TMPDIR/python-olm-src"
cd "$TMPDIR/python-olm-src"

curl -L -o python-olm-3.2.16.tar.gz \
  https://files.pythonhosted.org/packages/source/p/python-olm/python-olm-3.2.16.tar.gz
tar -xzf python-olm-3.2.16.tar.gz

sed -i 's/T \* const other_pos = other._data;/T * other_pos = other._data;/' \
  python-olm-3.2.16/libolm/include/olm/list.hh

grep -n 'other_pos' python-olm-3.2.16/libolm/include/olm/list.hh

export ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"
export CMAKE_POLICY_VERSION_MINIMUM=3.5

pip install ./python-olm-3.2.16

Vuelve a la carpeta del projecto

pip install -r requirements.txt

uname -m
curl -fL -o "$TMPDIR/deltachat-rpc-server" \
  https://github.com/chatmail/core/releases/download/v2.62.0/deltachat-rpc-server-arm64-v8a-android
chmod +x "$TMPDIR/deltachat-rpc-server"
"$TMPDIR/deltachat-rpc-server" --version

cp "$(command -v deltachat-rpc-server)" \
   "$(command -v deltachat-rpc-server).old"
cp "$TMPDIR/deltachat-rpc-server" "$(command -v deltachat-rpc-server)"
deltachat-rpc-server --version

cp .env.example .env

En .env, configura:

Las credenciales de cada plataforma son globales a la ejecución. Para conectar varias salas en una ejecución, define los puentes en el archivo indicado por BRIDGES_FILE. Copia bridges.example.yml a bridges.yml, configura los destinos en ese archivo y establece BRIDGES_FILE=bridges.yml en .env. Cada puente necesita al menos dos plataformas y los destinos no se pueden repetir entre puentes:

bridges:
  - name: familia
    telegram_chat_id: -1001111111111
    discord_channel_id: 123456789012345678
    matrix_room_id: "!familia:matrix.org"
    xmpp_room_jid: "familia@muc.example.org"
    telegram_blind: true
    discord_blind: true

  - name: amigos
    telegram_chat_id: -1002222222222
    discord_channel_id: 234567890123456789
    matrix_room_id: "!amigos:matrix.org"
    xmpp_room_jid: "amigos@muc.example.org"
    telegram_blind: false
    discord_blind: false

Cada puente puede incluir telegram_chat_id, discord_channel_id, delta_chat_id, matrix_room_id y/o xmpp_room_jid. También se acepta el nombre anterior deltachat_chat_id. Los campos telegram_blind y discord_blind son opcionales y, si se omiten, heredan TELEGRAM_BLIND y DISCORD_BLIND. Cuando se usa el archivo YAML, se ignoran los IDs de destino individuales de .env; los tokens y las cuentas de cada plataforma se configuran una sola vez. La cuenta de Matrix debe estar unida a todas las salas; la cuenta Delta Chat debe tener acceso a todos sus chats; y la cuenta XMPP debe poder unirse a cada sala MUC. Se crea un almacén local de IDs por puente para mantener separadas las respuestas, ediciones y eliminaciones.

Sin BRIDGES_FILE, se usa el formato antiguo de un único puente: Telegram necesita su token y chat ID; Discord, su token y canal; Delta Chat, su chat ID; Matrix, homeserver, usuario, sala y token o contraseña; XMPP, cuenta, contraseña y sala MUC.

  • TELEGRAM_BOT_TOKEN: token creado con @BotFather.

  • TELEGRAM_CHAT_ID: ID del chat o grupo de Telegram al que se conectará el bot.

  • TELEGRAM_BLIND=true: en mensajes de Discord, Delta Chat, Matrix y XMPP hacia Telegram, solo envía un aviso con la inicial del remitente y sin el contenido. Telegram sigue aceptando mensajes y reenviándolos completos a las otras plataformas. También omite en Telegram los adjuntos recibidos desde ellas; si se supera el límite de tamaño, el aviso puede incluir el formato y tamaño del archivo. Por defecto está activado.

  • TELEGRAM_PRIVACY_URL: URL de privacidad enlazada en los avisos ciegos de Telegram y Discord; por defecto https://gist.github.com/benrusza/17c7bb417f3a024976189adaba78973c.

  • DISCORD_BOT_TOKEN: token del bot creado en el Discord Developer Portal.

  • DISCORD_CHANNEL_ID: ID del canal de texto que conectará el puente. Activa el modo desarrollador de Discord para copiarlo. En la página del bot, habilita Message Content Intent; invita al bot al servidor con permisos para ver el canal, enviar mensajes y adjuntar archivos. La integración reenvía adjuntos de hasta 50 MB y stickers como archivos; Discord puede rechazar subidas mayores según el límite del servidor o la cuenta. No sincroniza ediciones o eliminaciones hacia o desde Discord.

  • DISCORD_BLIND=true: en mensajes recibidos desde Telegram, Delta Chat, Matrix y XMPP, envía a Discord solo un aviso con la inicial del remitente y sin el contenido. También omite los adjuntos recibidos desde esas plataformas. Discord sigue aceptando mensajes y reenviándolos completos a las demás plataformas. El aviso usa la URL configurada en TELEGRAM_PRIVACY_URL. Por defecto está activado.

  • XMPP_ACCOUNT_JID y XMPP_PASSWORD: credenciales de la cuenta XMPP global del puente. XMPP_NICK es opcional; por defecto usa el usuario del JID. Configura cada sala MUC en bridges.yml con xmpp_room_jid (XMPP_ROOM_JID para la configuración antigua de un único puente). El bot debe poder entrar en esas salas. La conexión requiere TLS (STARTTLS o TLS directo) y valida los certificados; no se usa OMEMO ni otro cifrado de extremo a extremo. El servidor XMPP, los miembros de la sala y el servicio de carga pueden acceder al contenido y a los archivos. Para enviar archivos, el servidor debe ofrecer HTTP File Upload (XEP-0363) y permitir el tamaño del adjunto. Si el puente informa HTTP 405 durante una carga, el servidor o proxy de carga no está aceptando el método PUT en la URL de slot anunciada por XMPP.

  • DELTACHAT_EMAIL y DELTACHAT_PASSWORD: credenciales de la cuenta de Delta Chat. Solo hacen falta al crear/configurar la cuenta por primera vez.

  • DELTACHAT_DISPLAY_NAME: nombre de perfil que verán tus contactos; por defecto, Puente Delta-Telegram.

  • DELTACHAT_DATA_DIR: almacenamiento local de la cuenta; por defecto .data/deltachat/.

  • MATRIX_HOMESERVER: URL del homeserver, por ejemplo https://matrix.org.

  • MATRIX_USER_ID (o MATRIX_USERNAME): usuario completo de Matrix, por ejemplo @puente:matrix.org.

  • MATRIX_ROOM_ID: ID de la sala, normalmente comienza con !.

  • MATRIX_TOKEN o MATRIX_PASSWORD: token de acceso (recomendado) o contraseña de la cuenta Matrix del bot. No configures ambos salvo que quieras que se use el token.

  • MATRIX_DEVICE_ID: ID del dispositivo para la sesión Matrix; por defecto TERMUXBRIDGE.

  • MATRIX_ENCRYPTED: activa el cifrado E2E de Matrix; por defecto true.

  • MATRIX_ALLOW_UNVERIFIED_DEVICES: permite enviar mensajes cifrados a dispositivos Matrix no verificados; por defecto true. Desactívalo para que Matrix rechace esos envíos hasta que verifiques los dispositivos.

  • MATRIX_STORE_DIR: almacenamiento local de sesión y claves criptográficas; por defecto .data/matrix/. No lo borres ni lo compartas.

  • MATRIX_PICKLE_KEY: secreto aleatorio para proteger las claves E2E guardadas localmente. No lo compartas ni lo pierdas: el bot lo necesita al reiniciar.

  • BRIDGE_MESSAGE_STORE_PATH: base SQLite local con los IDs necesarios para editar mensajes reenviados; por defecto .data/bridge.sqlite. Guarda IDs y hashes del texto, no el contenido. Si se elimina, los mensajes antiguos ya no se podrán editar desde su plataforma de origen.

Matrix

En .env, MATRIX_ENCRYPTED=true, añade la sala cifrada y configura MATRIX_PICKLE_KEY con un secreto aleatorio. Puedes generarlo con:

openssl rand -hex 32

Invita la cuenta Matrix del bot a la sala cifrada. Al conectarse por primera vez, el bot registrará su dispositivo y claves; no se puede verificar de momento ese dispositivo desde Element para que los demás miembros puedan confiar en él. Mantén MATRIX_STORE_DIR y MATRIX_PICKLE_KEY seguros y persistentes entre reinicios. Si pierdes el store, el bot perderá sus claves y puede que no pueda leer mensajes anteriores. Para una sala sin cifrado se puede configurar MATRIX_ENCRYPTED=false.

Con MATRIX_ALLOW_UNVERIFIED_DEVICES=true, Matrix también enviará la clave de cifrado de la sala a dispositivos no verificados. El mensaje sigue cifrado, pero esos dispositivos podrán leerlo; verifica los dispositivos de la sala si no confías en ellos.

El cifrado solo protege el tramo Matrix hasta el dispositivo del bot. El puente descifra los mensajes para reenviarlos, por lo que el contenido de una sala cifrada también se enviará en texto a Telegram y Delta Chat.

Delta chat

Primero deja la cuenta de Delta Chat en línea:

python bridge.py --setup-deltachat

El comando genera el QR de invitación del bot en .data/deltachat/setup-contact.svg. Ábrelo en la pantalla y, desde Delta Chat, usa el icono QR para escanearlo. Así se establece el contacto seguro; añadir la dirección como un correo normal puede no crear un chat Delta Chat. Deja el comando activo durante el escaneo. Cuando termine, pulsa Ctrl+C y lista los chats:

python bridge.py --list-chats

Pon el ID del chat elegido en DELTACHAT_CHAT_ID y los datos de Telegram en .env. El bot crea/configura la cuenta Delta Chat automáticamente si aún no existe. Finalmente, arranca el puente:

python bridge.py

Para añadir otro dispositivo a la misma cuenta Delta Chat, detén primero el puente y ejecuta:

python bridge.py --deltachat-second-device

El comando crea un QR temporal en .data/deltachat/add-second-device.svg. Ábrelo para escanearlo desde la opción «Añadir segundo dispositivo» de Delta Chat en el otro dispositivo. Mantén el comando abierto hasta que termine la transferencia; el QR se elimina al finalizar. No compartas ni publiques ese QR: permite transferir la cuenta y sus datos. Para este comando debe estar instalado qrencode.

El bot ignora sus propios mensajes, así que los mensajes reenviados no vuelven a circular entre plataformas. Las ediciones de mensajes de texto se aplican sobre los mensajes reenviados cuando el puente tiene guardada su correspondencia local. Esto funciona para mensajes reenviados después de activar esta función; no convierte ediciones en mensajes nuevos. Las respuestas también se conservan entre plataformas como respuestas o citas nativas cuando el mensaje original fue reenviado por el puente y su correspondencia sigue guardada. XMPP usa XEP-0461 para respuestas, XEP-0308 para ediciones y XEP-0424 para retractaciones; su disponibilidad visual depende del cliente y del servidor de la sala. Las eliminaciones de mensajes de Delta Chat, las redacciones de Matrix y las retractaciones XMPP se propagan a las demás plataformas para los mensajes cuya correspondencia guarda el puente. Telegram Bot API no notifica al bot cuando un usuario borra un mensaje normal, por lo que no es posible detectar eliminaciones originadas en Telegram. Los borrados enviados por el puente están sujetos a los permisos y límites de cada plataforma. Al propagar una redacción de Matrix a Delta Chat, se solicita «borrar para todos»; Delta Chat solo lo permite para mensajes propios en chats cifrados.

Para usar solo Delta Chat y Matrix, deja vacías las variables TELEGRAM_* y ejecuta python bridge.py; no hace falta tener un bot de Telegram.

Para usar Discord con Telegram, configura DISCORD_BOT_TOKEN y DISCORD_CHANNEL_ID, y configura también las credenciales de al menos otra plataforma. Los mensajes de Discord con texto se envían a las demás plataformas activas; los mensajes que el bot publique no vuelven a circular.

Para ejecutarlo en segundo plano:

  nohup python3 bridge.py > bridge.log 2>&1 < /dev/null &

Sin guardar log:

nohup python3 bridge.py > /dev/null 2>&1 < /dev/null &

Telegram

Si conectas un grupo de Telegram, desactiva el modo de privacidad del bot con /setprivacy en BotFather para que pueda recibir todos los mensajes del grupo. Los mensajes se retransmiten entre tres servicios distintos; revisa las condiciones y privacidad de cada uno antes de usarlo con información sensible. Para ver el recorrido de los mensajes y las implicaciones de privacidad de Telegram, consulta PRIVACIDAD_TELEGRAM.md.

El servidor RPC de Delta Chat se instala como dependencia en el entorno virtual. La cuenta y las credenciales de Telegram se mantienen fuera del control de versiones (.data/ y .env están ignorados).

Estructura del código

  • bridge_app/settings.py: carga y valida la configuración.
  • bridge_app/delta_chat.py: cuenta, eventos y conexión con Delta Chat.
  • bridge_app/telegram.py: ciclo de vida del puente y coordinación de mensajes.
  • bridge_app/discord_service.py: conexión y mensajería de texto de Discord.
  • bridge_app/telegram_input.py: recepción y validación de mensajes de Telegram.
  • bridge_app/telegram_media.py: conversión y envío de adjuntos de Telegram.
  • bridge_app/message_formatting.py: etiquetas, colores y formato por plataforma.
  • bridge_app/cli.py: opciones de consola y arranque.
  • bridge.py: lanzador compatible; también puedes usar python -m bridge_app.

Licencia

Este proyecto está publicado bajo la licencia GNU GPL versión 3 o, a elección del usuario, cualquier versión posterior (GPL-3.0-or-later). Consulta LICENSE o el texto oficial.