Bangumi-syncer
Herramienta de sincronización automática entre media servers (Plex, Emby, Jellyfin) y la plataforma Bangumi. Automatiza el marcado de progreso de episodios al finalizar reproducción en clientes compatibles.
Ficha actualizada 24 sept 2026, 2:19 · upstream 24 sept 2026, 2:04 · release v3.11.3
Qué es Bangumi-syncer
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Bangumi-syncer es una herramienta open source diseñada para conectar servicios de medios como Plex, Emby, Jellyfin y Trakt con la plataforma Bangumi (番组计划). Su función principal es automatizar el registro del progreso de visualización: cuando un usuario finaliza un episodio en su media server, el sistema detecta el evento y actualiza automáticamente el estado en Bangumi mediante su API oficial.
La aplicación ofrece una interfaz web moderna para la gestión completa de configuraciones sin necesidad de editar archivos manualmente. Soporta múltiples usuarios con autenticación por servidor, permitiendo que cada cuenta de media server se vincule a un usuario distinto de Bangumi. Incluye capacidades de notificación vía Webhook y correo electrónico, así como mecanismos de recuperación ante fallos de API mediante colas de reintentos.
Técnicamente está construida sobre Node.js y Python con FastAPI, lo que permite una arquitectura escalable y mantenible. El proyecto incluye un Dockerfile para despliegue simplificado en contenedores, aunque no proporciona archivos docker-compose por defecto. Los requisitos mínimos son modestos: 2 núcleos CPU y 2 GB de RAM son suficientes para operación estable.
- Automatizar el marcado de progreso de episodios en Bangumi al terminar de ver contenido en Plex, Emby o Jellyfin sin intervención manual
- Gestionar múltiples cuentas de Bangumi simultáneamente, asignando cada media server a un usuario específico para evitar mezcla de datos
- Configurar notificaciones personalizadas vía Webhook (Telegram,钉钉) o correo electrónico al completar sincronizaciones o detectar errores
- Utilizar el sistema de colas de reintentos para garantizar que los datos se sincronicen incluso si la API de Bangumi está temporalmente inoperativa
- Interfaz web completa con hot-reload: todas las configuraciones se pueden modificar sin reiniciar el servicio
- Soporte nativo para múltiples drivers de media servers incluyendo Plex (Tautulli/Webhooks), Emby, Jellyfin y Trakt
- Mecanismo de recuperación automática mediante colas de reintentos cuando la API de Bangumi no responde
- Sistema de notificaciones altamente configurable con plantillas personalizables para integraciones externas
- Requiere conexión estable a internet para comunicarse con la API de Bangumi, aunque el sistema local puede funcionar en modo offline con caché
- Soporte limitado para contenido tipo '剧场版' (películas) en ciertos drivers como Trakt y fongmi que no marcan progreso completo automáticamente
- El proyecto es mantenido por un desarrollador individual sin soporte profesional, por lo que la resolución de problemas puede requerir conocimientos técnicos
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
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.
Desplegar usando Docker con al menos 2GB de RAM asignada. Asegurar conectividad estable a las APIs de Bangumi y configurar correctamente las variables de entorno para autenticación. El sistema soporta hot-reload de configuración sin reinicios completos.
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.