Trawlarr
Trawlarr es una herramienta open source que actúa como puente entre TMDB y tu stack *arr, permitiendo búsquedas avanzadas con filtros de descubrimiento, listas automáticas de contenido nuevo y un asistente de lenguaje natural para encontrar películas y series.
Ficha actualizada 22 sept 2026, 16:16 · upstream 29 ago 2026, 6:52 · release v1.0.0
Qué es Trawlarr
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Trawlarr es una aplicación autoalojada diseñada para complementar Radarr y Sonarr, proporcionando capacidades de búsqueda avanzada que estas herramientas no ofrecen nativamente. Mientras que Radarr y Sonarr están optimizados para gestionar contenido una vez descubierto, Trawlarr se enfoca en ayudarte a decidir qué buscar mediante filtros avanzados de la API de descubrimiento de TMDB.
La aplicación permite configurar múltiples filtros como géneros (incluidos y excluidos), ventanas de estreno, calificaciones mínimas, conteo de votos, duración, idioma original, país de origen, clasificación por edad, reparto, personal clave, palabras clave, compañías de producción, proveedores de streaming y tipo de monetización. Los resultados muestran únicamente el contenido que falta en tu biblioteca actual.
Trawlarr incluye tres funcionalidades principales: filtros avanzados de descubrimiento de TMDB, listas automáticas que escanean cada 12 horas para añadir nuevo contenido automáticamente, y un asistente de lenguaje natural opcional que convierte consultas naturales en filtros aplicables. El asistente requiere una clave API de Mistral y puede proporcionar resúmenes hablados sin spoilers.
La aplicación está construida con FastAPI en Python 3.12, utiliza una interfaz frontend SPA en JavaScript vanilla sin framework, y se ejecuta en un único contenedor Docker compatible con amd64 y arm64. Los credenciales de TMDB, Radarr y Sonarr se manejan del lado del servidor y nunca llegan al navegador.
- Descubrir películas y series mediante filtros avanzados de TMDB Discovery API sin necesidad de títulos específicos
- Configurar listas automáticas que escanean periódicamente y añaden nuevo contenido a Radarr o Sonarr automáticamente
- Usar el asistente de lenguaje natural para buscar contenido con consultas conversacionales como 'películas de terror de los 80 con calificación superior a 6.5'
- Obtener resúmenes hablados sin spoilers de títulos específicos antes de añadirlos a la biblioteca
- Integrarse con Radarr y Sonarr existentes mediante sus APIs para añadir contenido directamente a las bibliotecas
- Monitorear múltiples colecciones simultáneamente, como todas las películas de una compañía de producción específica
- Soporta todos los parámetros de la API TMDB Discover incluyendo géneros, calificaciones, conteo de votos, idioma original y proveedores de streaming
- Funcionalidad de listas automáticas que escanean cada 12 horas y añaden contenido nuevo automáticamente a Radarr o Sonarr
- Asistente de lenguaje natural opcional con Mistral API para consultas conversacionales y resúmenes hablados sin spoilers
- Interfaz frontend SPA en JavaScript vanilla sin framework, sin pasos de compilación y sin dependencias CDN
- Soporte nativo para arquitecturas amd64 y arm64, compatible con Raspberry Pi y N100
- Manejo seguro de credenciales: TMDB, Radarr y Sonarr API keys se almacenan del lado del servidor
- No incluye autenticación propia; requiere exponer el puerto 8080 detrás de proxy inverso autenticado, VPN o Tailscale
- El asistente de lenguaje natural consume cuota de la API de Mistral proporcionada por el usuario
- La interfaz solo soporta inglés y francés; añadir otros idiomas requiere editar manualmente app/static/i18n.js
- No hay switcher de idioma en la UI; para cambiar de idioma se debe ejecutar localStorage.setItem('ui-lang','fr') en consola del navegador
- Los auto-lists persisten solo en lists.json dentro de DATA_DIR; no hay base de datos externa
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.
Requiere TMDB API key gratuita, claves API de Radarr y Sonarr. Ejecutar como uid 1000:1000 creando el directorio data antes del contenedor. Bind al puerto 8080 local (127.0.0.1) por defecto; cambiar mapeo de puerto si necesario. Para Mistral API, dejar MISTRAL_API_KEY vacío para ocultar la funcionalidad. Configurar RADARR_URL/SONARR_URL con nombres de servicio Docker o host.docker.internal según arquitectura.
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.