Publicado por
Sonarr: PVR inteligente para Usenet y BitTorrent
Gestión automatizada de series de televisión con monitorización RSS, renombrado y actualización de calidad
Vídeo tutorial en YouTube
Mira el vídeo completo sobre cómo instalar y usar Sonarr: PVR inteligente para Usenet y BitTorrent en el canal GENBYTE:
¿Qué es Sonarr: PVR inteligente para Usenet y BitTorrent?
Sonarr es un grabador de vídeo personal (PVR) diseñado para usuarios de Usenet y BitTorrent. Monitoriza múltiples fuentes RSS en busca de nuevos episodios de las series configuradas, descarga, ordena y renombra los archivos automáticamente. Además, detecta cuando hay disponibles versiones de mayor calidad de episodios ya descargados y realiza la actualización de forma autónoma. El proyecto está desarrollado principalmente en C# y cuenta con una interfaz web construida con React y TypeScript.
Características principales
Monitorización automática de episodios
Vigila múltiples feeds RSS para detectar nuevos episodios de las series añadidas y los descarga sin intervención manual.
Escaneo de biblioteca existente
Analiza la biblioteca local para identificar episodios faltantes y procede a su descarga automática.
Actualización de calidad automática
Cuando aparece una versión de mayor calidad (por ejemplo, de DVD a Blu-Ray), Sonarr la descarga y reemplaza el archivo anterior.
Manejo de descargas fallidas
Si una descarga falla, el sistema intenta obtener otro release automáticamente.
Búsqueda manual
Permite buscar y seleccionar releases específicos o investigar por qué un episodio no se descargó automáticamente.
Renombrado configurable de episodios
Ofrece un sistema de renombrado totalmente personalizable para mantener la biblioteca organizada según las preferencias del usuario.
Integración con clientes de descarga
Compatible de forma nativa con SABnzbd y NZBGet para la gestión de descargas Usenet.
Integración con servidores multimedia
Notifica y actualiza bibliotecas en Kodi y Plex, incluyendo metadatos, tras cada nueva descarga o actualización.
Soporte para especiales y multi-episodio
Gestiona correctamente episodios especiales y releases que contienen varios episodios en un solo archivo.
Interfaz web moderna
Interfaz de usuario construida con React, TypeScript y Vite, accesible desde navegador.
Requisitos del sistema
- Windows, Linux, macOS o Raspberry Pi (plataformas soportadas oficialmente)
- Cliente de descarga compatible: SABnzbd o NZBGet (recomendado para Usenet)
- Cliente BitTorrent compatible (para usuarios de BitTorrent)
- Servidor multimedia opcional: Kodi o Plex para notificaciones y actualización de biblioteca
- Runtime .NET (versión no especificada en la documentación recopilada)
- Node.js 24.19.0 y Yarn 1.22.22 para compilar la interfaz frontend (solo desarrollo)
Instalación con Docker Compose
Descarga oficial
El proyecto no incluye archivos Docker Compose ni instrucciones de contenedor en la documentación recopilada. La instalación oficial se realiza mediante los paquetes proporcionados en la página de descargas del proyecto.
# https://sonarr.tv/#downloads-v3
# Seleccionar el paquete correspondiente al sistema operativo
Compilación del frontend (desarrollo)
Para contribuir o compilar la interfaz de usuario, el repositorio incluye scripts basados en Yarn y Vite.
git clone https://github.com/Sonarr/Sonarr.git
cd Sonarr
# Instalar dependencias
yarn install
# Compilar para producción
yarn build
# Servidor de desarrollo
yarn start
Acceder al proyecto
Interfaz web
Sonarr expone una interfaz web accesible desde el navegador. El puerto por defecto no está documentado en la investigación recopilada; consultar la wiki oficial o la configuración tras la instalación.
API REST
Documentación de la API disponible en https://sonarr.tv/docs/api para integraciones externas y automatización avanzada.
Casos de uso
- Automatizar la descarga y organización de series de televisión desde Usenet
- Automatizar la descarga y organización de series de televisión desde BitTorrent
- Mantener una biblioteca de series siempre actualizada con la mejor calidad disponible
- Integrar la gestión de series con Plex o Kodi para notificaciones y actualización de metadatos
- Reemplazar archivos de menor calidad por versiones superiores (DVD → Blu-Ray → 4K) sin intervención manual
- Gestionar episodios especiales y releases multi-episodio de forma correcta
Configuración avanzada
Configuración de perfiles de calidad
Permite definir perfiles de calidad personalizados para cada serie, estableciendo preferencias de resolución, códec, fuente y grupo de release.
# Crear o editar perfiles según necesidades
# Asignar perfil a cada serie en su configuración
Integración con indexadores y clientes
Configuración de indexadores (Jackett, Prowlarr, etc.) y clientes de descarga (SABnzbd, NZBGet, qBittorrent, Transmission, etc.) desde la interfaz.
# Configuración → Cliente de descarga → Añadir cliente
# Probar conexión y guardar
API para automatización externa
La API REST permite crear, modificar y consultar series, episodios, colas, historial y configuración mediante peticiones HTTP autenticadas con API key.
# Ejemplo: listar series
curl -H "X-Api-Key: TU_API_KEY" http://localhost:puerto/api/v3/series
Gestión y mantenimiento
Actualizaciones
Las actualizaciones se gestionan desde la propia interfaz (Configuración → General → Actualizaciones) o mediante el gestor de paquetes del sistema operativo. El proyecto sigue un modelo de ramas (v5-develop como rama por defecto en GitHub).
# O seguir instrucciones específicas del SO en la wiki
Copia de seguridad de la base de datos
Sonarr utiliza una base de datos SQLite (ubicación dependiente del SO). Se recomienda realizar copias periódicas del directorio de datos completo.
# Copiar archivo sonarr.db y directorio Backups
# Automatizar con script programado o herramienta de backup
Limpieza de archivos temporales y logs
La interfaz incluye opciones para limpiar la cola de descargas, el historial y los logs antiguos desde Configuración → General → Interfaz.
# Configuración → General → Interfaz → Limpiar historial (según retención configurada)
Stack técnico
- C# (.NET) – Backend principal
- React 18 – Interfaz de usuario
- TypeScript 5.7 – Tipado estático en frontend
- Vite 8.3 – Bundler y servidor de desarrollo
- Yarn 1.22 – Gestor de paquetes
- Node.js 24.19 – Runtime JavaScript (desarrollo frontend)
- SQLite – Base de datos embebida
- SignalR – Comunicación en tiempo real
- TanStack Query – Gestión de estado servidor
- Zustand – Gestión de estado cliente
- Chart.js – Gráficos y estadísticas
- Fuse.js – Búsqueda difusa
- GNU GPL v3 – Licencia
Referencias oficiales
- Repositorio oficial en GitHub: https://github.com/Sonarr/Sonarr
- Sitio web oficial: https://sonarr.tv
- Página de descargas: https://sonarr.tv/#downloads-v3
- Wiki oficial (documentación completa): https://wiki.servarr.com/Sonarr
- Preguntas frecuentes: https://wiki.servarr.com/sonarr/faq
- Documentación de la API REST: https://sonarr.tv/docs/api
- Foros de la comunidad: https://forums.sonarr.tv/
- Servidor Discord: https://discord.gg/M6BvZn5
- Subreddit oficial: https://www.reddit.com/r/sonarr
- Canal IRC en Libera.Chat: https://web.libera.chat/?channels=#sonarr
- Página de donaciones: https://sonarr.tv/donate
Apoya el canal GENBYTE
¿Te ha sido útil este contenido?
Suscríbete a YouTube
Newsletter GENBYTE
Ko-fi
Contacto: [email protected]