jellygram
JellyGram es un bot Telegram auto-alojado para Jellyfin que permite a usuarios registrados enviar archivos multimedia (MP4, MKV, AVI, MOV) directamente desde Telegram o la Mini App.
Ficha actualizada 22 sept 2026, 16:15 · upstream 7 sept 2026, 13:43 · release sin release detectada
Qué es jellygram
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
JellyGram es una aplicación auto-alojada diseñada para gestionar medios en servidores Jellyfin mediante integración con Telegram. Permite a usuarios registrados enviar archivos multimedia directamente desde chats de Telegram o la Mini App móvil, eliminando la necesidad de acceso SSH o gestión manual de carpetas. El sistema procesa automáticamente los archivos: identificación por nombre de archivo y TMDB, renombrado según estándares Jellyfin, organización en carpetas privadas por usuario y escaneo automático.
La arquitectura utiliza Next.js con TypeScript, PostgreSQL para cola persistente y Redis. Soporta archivos grandes hasta 5 GiB mediante múltiples métodos de subida (Bot API local, direct uploader, MTProto). Destaca su enfoque en privacidad per-usuario mediante bibliotecas aisladas en Jellyfin y auditoría continua vía API oficial.
El despliegue requiere Node.js 22+, PostgreSQL 14+ y Jellyfin 10.8+. Incluye plantillas systemd, docker-compose para PostgreSQL y Bot API local, con recursos estimados de 4 núcleos CPU, 4 GB RAM y 30 GB disco.
- Usuarios de homelab que desean aceptar medios sin ser el cuello de botella de subida manual
- Hogares o grupos pequeños que comparten un servidor Jellyfin con privacidad per-usuario garantizada
- Administradores que necesitan una interfaz amigable vía Telegram para gestionar contenido multimedia
- Usuarios que buscan evitar la configuración manual de permisos y carpetas en Jellyfin
- Privacidad per-usuario mediante bibliotecas aisladas en Jellyfin con auditoría continua vía API oficial
- Soporte para archivos grandes hasta 5 GiB mediante múltiples métodos de subida (Bot API local, direct uploader, MTProto)
- Identificación automática de medios por nombre de archivo y TMDB con integración directa
- Cola persistente en PostgreSQL que permite reanudar descargas interrumpidas sin pérdida de datos
- Validación de archivos con ffprobe antes de almacenar para evitar corrupción o formatos no soportados
- Dependencia de Node.js 22+ y TypeScript estricto, lo que puede limitar entornos legacy
- Sin Dockerfile nativo; requiere docker-compose.yml para contenerización completa
- Configuración manual de credenciales de Jellyfin (API key) y Telegram (bot token)
- Requiere acceso directo a la API de Jellyfin con permisos adecuados en el servidor
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.
Despliegue recomendado: systemd unit o Docker Compose. Requiere Node.js 22+, PostgreSQL 14+ y Jellyfin 10.8+. Recursos mínimos: 4 núcleos CPU, 4 GB RAM, 30 GB disco. Configurar reverse proxy (nginx/caddy) con SSL. Usar docker-compose.yml incluido para PostgreSQL y Bot API local. Verificar permisos de carpetas y setgid bit en directorios de medios.
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.