Documentación de UltraTorrent
UltraTorrent es una plataforma auto-hospedada de adquisición y gestión de medios. Busca medios, los descarga, los identifica, los organiza en una biblioteca limpia y le avisa a tu servidor de medios — según las reglas que tú escribas, sin que tengas que estar pendiente.
Es una sola aplicación que reemplaza un montón de ellas: un gestor de clientes de descarga, un agregador de indexadores, un motor de automatización de RSS, un cazador de episodios faltantes, un organizador de bibliotecas y un panel de analíticas del servidor de medios.
Inicio Rápido → instala con Docker Compose, inicia sesión, agrega un indexador y termina tu primera descarga. Luego lee Conceptos Básicos para que el resto de la documentación te haga sentido.
Escoge tu ruta
| Quiero… | Ve aquí |
|---|---|
| Entender qué es esto y cómo encajan las piezas | Conceptos Básicos · Resumen de la Arquitectura |
| Conseguir el software | Obtener UltraTorrent |
| Instalarlo — Docker, NAS, Proxmox, la nube | Instalación · Instalador guiado |
| Lograr que mi primera descarga funcione | Inicio Rápido · Mi Primera Descarga |
| Automatizar una serie de TV de principio a fin | Automatizar Series de TV |
| Configurar una función a fondo | Módulos |
| Llamar a la API | Referencia de la API REST |
| Arreglar algo que está roto | Resolución de Problemas |
| Operarlo en serio — asegurar, respaldar, afinar | Operar |
| Extenderlo o contribuir | Desarrollar |
Lo que realmente hace
Cada etapa es un módulo que puedes configurar, automatizar o apagar por completo. Consulta la Referencia de Módulos para ver el catálogo completo y cómo dependen unos de otros.
La documentación, de un vistazo
- Aprender — conceptos, inicio rápido, tutoriales y flujos de trabajo de principio a fin. Empieza aquí si eres nuevo.
- Instalación — Docker Compose es la instalación de referencia; toda otra plataforma (Synology, QNAP, Unraid, TrueNAS, Proxmox, la nube…) es una capa fina encima de ella. Obtener UltraTorrent cubre de dónde sale el software, y el instalador guiado hace toda la instalación de Compose desde un solo binario.
- Módulos — una página a fondo por función: qué es, por qué, cuándo, cómo configurarla, qué sale mal y cómo arreglarlo.
- Referencia — generada desde el código fuente al compilar, así que no puede desactualizarse: cada endpoint REST, cada permiso, cada variable de entorno, cada modelo de la base de datos.
- Operar — resolución de problemas, seguridad, backup y recuperación ante desastres, rendimiento y mantenimiento.
- Desarrollar — arquitectura, el sistema de proveedores, cómo escribir un módulo, pruebas.
API REST, Permisos, Módulos, Variables de Entorno y el Esquema de la Base de Datos se generan desde el código que se publica. Si una página de ahí está mal, el código está mal — lo cual hace que sea seguro confiar en ella.
Convenciones usadas en esta documentación
A lo largo del sitio vas a ver:
Una recomendación, o una forma más rápida de hacer algo.
Algo con lo que la gente suele tropezar. Léelo antes de que te pase.
Pérdida de datos, o una exposición de seguridad. No te lo saltes.
Algunas páginas todavía llevan una nota como esta, nombrando la pantalla exacta que hay que capturar. Todas son pantallas dentro de otros productos — Synology, QNAP, Portainer, TrueNAS, Unraid, Proxmox — que no podemos capturar por ti. Contribuir una es sobrescribir un archivo: conserva el nombre del archivo, no hace falta cambiar el texto.
Las capturas de pantalla de UltraTorrent mismo están censuradas: los títulos de medios, las rutas de archivos y los nombres de usuario del servidor de medios están difuminados, mientras que la interfaz — botones, insignias, conteos, barras de progreso — se mantiene nítida. Eso es a propósito, y es la razón por la que las pantallas se ven cargadas pero ilegibles en algunas partes.
Toda página sustancial termina con una Lista de verificación — pasos de verificación y el resultado que deberías esperar — para que siempre sepas si lo que acabas de hacer de verdad funcionó.
Cómo conseguir ayuda
- Busca en este sitio (arriba a la derecha, o presiona Ctrl/⌘ + K).
- Revisa las Preguntas Frecuentes y el Glosario.
- Trabaja con Resolución de Problemas — está organizada por síntoma, y cada entrada te da los comandos de diagnóstico exactos.
- ¿Todavía atascado? Abre un issue en GitHub — e incluye los diagnósticos que la página de resolución de problemas te pidió recopilar.