- Python 100%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| bridge_app | ||
| tests | ||
| .env copy | ||
| .env.example | ||
| .gitignore | ||
| bridge.py | ||
| bridges.example.yml | ||
| bridges.yml | ||
| LICENSE | ||
| PRIVACIDAD_TELEGRAM.md | ||
| README.md | ||
| requirements.txt | ||
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 defectohttps://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 enTELEGRAM_PRIVACY_URL. Por defecto está activado. -
XMPP_ACCOUNT_JIDyXMPP_PASSWORD: credenciales de la cuenta XMPP global del puente.XMPP_NICKes opcional; por defecto usa el usuario del JID. Configura cada sala MUC enbridges.ymlconxmpp_room_jid(XMPP_ROOM_JIDpara 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 informaHTTP 405durante una carga, el servidor o proxy de carga no está aceptando el métodoPUTen la URL de slot anunciada por XMPP. -
DELTACHAT_EMAILyDELTACHAT_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 ejemplohttps://matrix.org. -
MATRIX_USER_ID(oMATRIX_USERNAME): usuario completo de Matrix, por ejemplo@puente:matrix.org. -
MATRIX_ROOM_ID: ID de la sala, normalmente comienza con!. -
MATRIX_TOKENoMATRIX_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 defectoTERMUXBRIDGE. -
MATRIX_ENCRYPTED: activa el cifrado E2E de Matrix; por defectotrue. -
MATRIX_ALLOW_UNVERIFIED_DEVICES: permite enviar mensajes cifrados a dispositivos Matrix no verificados; por defectotrue. 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 usarpython -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.
