immich_telegram_uploader
Herramienta de autoalojamiento que descarga fotos, videos y notas de Telegram (cuentas privadas o canales) y los sube a una instancia de Immich. Utiliza Python/Telethon para la autenticación y Docker para el despliegue, requiriendo configuración manual de credenciales vía variables de entorno.
Ficha actualizada 24 sept 2026, 13:10 · upstream 24 sept 2026, 12:52 · release v1.1
Qué es immich_telegram_uploader
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Esta herramienta actúa como puente entre Telegram e Immich, permitiendo importar medios desde chats privados o canales públicos a una biblioteca personal. Gestiona automáticamente la descarga de archivos y la subida a la API de Immich, verificando integridad mediante checksums SHA-1 para evitar duplicados. Ofrece la opción de crear álbumes en Immich nombrados según el origen del chat.
El despliegue recomendado es mediante Docker Compose, integrándose en la red existente del servidor Immich. Requiere una autenticación inicial interactiva donde Telethon solicita un código SMS para vincular la cuenta de Telegram con el contenedor. Tras este paso, las sesiones se persisten localmente.
La configuración depende de variables de entorno como TELEGRAM_APP_ID, TELEGRAM_API_HASH y credenciales de la API de Immich. El script ejecuta tareas en modo interactivo o mediante llamadas al archivo principal, gestionando directorios específicos para sesiones y descargas temporales.
- Migrar archivos multimedia de un canal público a la biblioteca personal de Immich
- Archivar conversaciones privadas con contenido multimedia sin perder datos
- Centralizar medios dispersos en Telegram en una sola instancia autoalojada
- Automatizar el backup de fotos de grupos mediante scripts programados
- Verificación de duplicados mediante SHA-1 checksum para optimizar almacenamiento
- Soporte nativo para notas de video de Telegram, no solo imágenes o clips
- Autenticación segura vía Telethon con persistencia de sesión tras el primer inicio
- Integración directa con la API REST de Immich sin dependencias externas complejas
- Arquitectura basada en contenedores Docker simplificada para integración
- Requiere autenticación manual inicial con SMS/confirmación cada vez que se reinicia el servicio si no se persiste la sesión correctamente
- Dependencia de credenciales de Telegram API válidas obtenidas desde my.telegram.org
- Necesita acceso explícito a la red Docker del servidor Immich para comunicarse
- No soporta subida automática continua sin ejecución manual del script principal (python3 main.py)
- Requiere configuración previa de claves API en el archivo .env antes del primer arranque
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Añadir servicio a docker-compose.yml existente. Asegurar que esté en la misma red Docker que Immich. Configurar variables TELEGRAM_APP_ID, TELEGRAM_API_HASH, IMMICH_API_URL e IMMICH_API_KEY en un archivo .env. Ejecutar autenticación inicial con 'docker exec -it immich_telegram_uploader python3 main.py'. Mantener directorios ./sessions y ./downloads montados o sincronizados.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.