Saltar a contenido

Guía de usuario

Lo justo para instalar Singularity, configurarlo y subir tu primer torrent sin tropezar. Para entrar a fondo en cada módulo está el Manual completo.

Qué hace

Singularity es una caja de herramientas para quien comparte su biblioteca en un tracker UNIT3D:

  • RawLoadrr sube: identifica la película o la serie, hace las capturas y el MediaInfo, comprueba duplicados, publica en el tracker y añade el torrent a tu cliente para sembrar.
  • CSI cruza tu biblioteca, tu cliente y el tracker para decirte qué te falta por subir.
  • MKVerything revisa y repara los ficheros antes de compartirlos.
  • UNIT3D Ed. edita en masa lo que ya tienes subido (descripciones, imágenes caídas).

Todo se maneja desde un menú: escribes singularity y eliges.

Instalar

En Linux, con Docker. Basta con tres ficheros:

mkdir -p ~/Singularity && cd ~/Singularity
for f in docker-compose.yml makefile final-user-install.sh; do
  curl -fsSLO "https://raw.githubusercontent.com/RawSmokeTerribilus/Singularity/main/linux-installer/$f"
done
make install   # crea config/ y work_data/, genera las plantillas, instala el comando singularity
make up        # descarga la imagen y arranca
singularity    # abre el menú

No ejecutes los make con sudo: el script pide permisos solo cuando le hacen falta.

Actualizar

cd ~/Singularity && make up

make up descarga la imagen nueva y actualiza los módulos de tracker de la suite. Lo que sustituye queda guardado en work_data/trackers_backup/. Los trackers que hayas creado tú no se tocan.

La primera vez: la aduana

Al entrar en RawLoadrr (2 en el menú), Singularity revisa lo que le falta y te lo pide una sola vez:

  1. Claves de API. Solo la de TMDB es obligatoria. El resto (imágenes, OMDb, Google Books, Twitch/IGDB, MyAnimeList) son opcionales: Enter la deja vacía y no se vuelve a preguntar. Lo que tecleas no se ve en pantalla; al recibir cada clave te enseña su longitud y los 4 últimos caracteres para que compruebes que es la buena.
  2. Cliente torrent. «¿Usas qBittorrent?». Si dices que sí, pide URL, puerto, usuario y contraseña de la WebUI y prueba la conexión. Con el compose oficial (network_mode: host) la URL es http://127.0.0.1. El puerto puede ir en la URL o aparte. Si usas Deluge, Transmission, rTorrent o una carpeta watch, se configura a mano en config/config.py (TORRENT_CLIENTS y DEFAULT → default_torrent_client), y la aduana lo respeta. Si dices que no, subirás sin sembrar.

MyAnimeList

Para identificar anime, crea una app en myanimelist.net/apiconfig y pega su Client ID. Sin él se usa solo AniList, que funciona pero acierta menos con títulos repetidos.

Tu tracker

En RawLoadrr:

  • [2] Configurar tracker existente: para los que trae la suite (NOBS y compañía). Pide la API key y la announce URL; ambas van ocultas al teclearlas y en las tablas.
  • [3] Crear nuevo tracker: para cualquier otro UNIT3D. Le das nombre, abreviatura, URL, API key y announce, y:
    • comprueba que de verdad es un UNIT3D;
    • lee del propio tracker los ids de sus categorías, tipos y resoluciones (cada UNIT3D numera a su manera);
    • si faltan, te ofrece pegar tu cookie de sesión para leerlos todos de la página de subida. Hace falta la cabecera Cookie entera (navegador con la sesión iniciada en ese tracker → F12 → Red → recarga → primera petición → Cabeceras de la petición → Cookie). Si no vale, te dice por qué y te deja repetir;
    • lo que siga faltando te lo pregunta, con los valores por defecto de UNIT3D como sugerencia, y te enseña la tabla final para que la confirmes.

Si escribes la abreviatura de un tracker que ya trae la suite, no genera nada nuevo: solo lo añade a tu configuración.

Subir

[1] Usar tracker existente → eliges tracker → [1] Subir desde una ruta → pegas la ruta de la carpeta o el fichero → opciones → ok.

Antes de subir de verdad, prueba con --debug (opción 6): hace todo menos la subida y al final te dice «Ensayos (--debug, sin subir): 1». Nada sale hacia el tracker.

Qué pasa en una subida:

  1. Identificación. Pregunta a varios proveedores (TMDB, OMDb, TVmaze y, en anime, MyAnimeList y AniList) y solo acepta un resultado si al menos dos coinciden. Si tu ruta lleva el id (Peli (2005) [tmdb-79200], [tt34672616], Serie 2019-TVdbID-355229), se verifica contra TMDB y se usa. Si no hay acuerdo, te pregunta; no adivina.
  2. Tipo y calidad. WEB-DL, WEBRip, Encode, Remux o HDTV se deciden por el MediaInfo, no por el nombre del fichero: un WEB-DL que pasó por Tdarr o HandBrake es un WEBRip. Si el nombre no dice el origen, se deduce del MediaInfo; si no hay señales, pregunta. Los criterios son los de la guía de calidades de NOBS.
  3. Duplicados. Busca en el tracker; si hay uno igual, no sube y te lo dice. Si la búsqueda no se puede hacer (tracker caído, clave mala), avisa y sube igual: el tracker rechaza los duplicados.
  4. Subida y siembra. Publica, descarga el .torrent oficial del tracker y lo añade a tu cliente apuntando a tus ficheros.

Al final sale un resumen con las subidas hechas, los ensayos y los fallos de toda la tanda.

Qué te falta por subir: CSI

En el menú: 4 Extras → 4.5 CSI. Cruza tu biblioteca (Sonarr/Radarr o una carpeta), tu qBittorrent y el tracker, y genera listas de lo que no está subido, lo que está subido pero falta en tu cliente y los posibles duplicados.

CSI necesita la cookie de sesión del tracker. La comprueba al abrir y solo la pide si de verdad ya no vale. Las sesiones de UNIT3D caducan tras unas horas sin uso, así que es normal que te la pida si llevas días sin abrirlo. Al pegarla la prueba antes de guardarla; vale el valor de la cookie de sesión o la cabecera Cookie entera.

Si algo falla

Síntoma Qué mirar
«No se pudo conectar a qBittorrent» URL y puerto de la WebUI; con el compose oficial, http://127.0.0.1.
Te pide un id en cada subida El nombre de la carpeta lleva demasiada basura; pon el id en la ruta ([tmdb-12345]) o usa --tmdb.
«No se pudo comprobar si hay duplicados» La API key del tracker o el propio tracker; la subida sigue igualmente.
CSI o UNIT3D Ed. piden la cookie La sesión ha caducado: cópiala de nuevo del navegador.
Un error del tracker al subir En pantalla sale una línea; la respuesta entera queda en work_data/tmp/<release>/[TRACKER]respuesta_HTTP<código>.html.

Las claves nunca se imprimen en pantalla ni en los logs: si necesitas enseñar un log para pedir ayuda, puedes hacerlo.