UNIT3D Mass Edition Suite

Conjunto de herramientas Python para curación y mantenimiento masivo de torrents en trackers basados en UNIT3D.

Misión

Automatizar tareas de edición tediosas:

✨ Restaurar metadatos perdidos (IMDb, TMDb, TVDb)
📦 Inyectar banners y firmas corporativas
🖼️ Resucitar imágenes rotas en descripciones
🔧 Arreglar errores de "Info Providers"
⚙️ Mantener sincronización tracker-local

Todo de forma automática y respetuosa con los límites del servidor.

La Filosofía: Pipeline de 4 Fases

La suite funciona como una cadena de montaje. Cada script realiza una tarea específica y prepara el terreno para el siguiente, asegurando un proceso ordenado y robusto:

[Scraper] → [Indexer] → [Mass Updater] → [Image Resurrector]
   IDs       Mapping    Metadatos      Imágenes & Formato

Flujo de Datos

sequenceDiagram
    participant Tracker as UNIT3D Tracker
    participant Local as Sistema Local
    participant Script1 as 01_scraper.py
    participant Script2 as 02_indexer.py
    participant Script3 as 03_mass_updater.py
    participant Script4 as 04_image_resurrector.py

    Script1->>Tracker: GET /users/{username}/uploads
    Tracker-->>Script1: HTML con torrents
    Script1->>Local: ids.txt

    Script2->>Local: Lee ids.txt
    Script2->>Local: Busca meta.json
    Script2->>Local: mapeo_maestro.json

    Script3->>Local: Carga mapeo_maestro.json
    Script3->>Tracker: PATCH /torrents/{id}/edit
    Script3->>Local: completados.txt (checkpoint)

    Script4->>Local: Carga completados.json
    Script4->>Local: Procesa imágenes
    Script4->>Tracker: PATCH /torrents/{id}/edit
    Script4->>Local: Actualiza DESCRIPTION.txt

Diseño Resiliente

Cada script genera archivos de control (ids.txt, mapeo_maestro.json, completados.txt) que permiten reanudar el proceso si se interrumpe. No hay pérdida de trabajo.

Alcance Actual

Los scripts están optimizados para trackers UNIT3D con arquitectura estándar (endpoints /torrents/{id}/edit, validación de XSRF, cookies de sesión). Trackers con protecciones personalizadas pueden requerir adaptaciones.

Casos de Uso

Caso	Script(s) Recomendado
He subido 500+ torrents y perdí metadatos	`02_indexer.py` + `03_mass_updater.py`
Mi banner antiguo está deprecado	`03_mass_updater.py` (reemplaza vía `MSG_VIEJO/MSG_NUEVO`)
Las imágenes de mis descripciones están rotas	`04_image_resurrector.py`
Necesito una restauración completa	Ejecutar los 4 scripts en orden
Tengo 50 torrents para editar	Modo Manual standalone

Próximos Pasos

Modo Recomendado: Consulta Workflows para integración vía singularity.py.
Detalles Técnicos: Lee Pipeline para comprender cada fase.
Despliegue: Revisa Setup & Seguridad para dependencias y consideraciones críticas.