Watchtower

## 🌐 Watchtower: Hub Multimedia Multiplataforma y Auto-alojable

**Watchtower** es una aplicación de código abierto construida con **Flutter**, diseñada para centralizar el consumo de anime, series, manga, novelas y música. Su arquitectura se distingue por ser **extensible mediante plugins JavaScript** (ejecutados en QuickJS), permitir la ejecución **headless (CLI)** en servidores Linux, e integrar un cliente BitTorrent nativo para streaming directo.

### 🏷️ Información General - **Autor:** [ferelking242](https://github.com/ferelking242) - **Licencia:** Apache 2.0 - **Plataformas:** Android, iOS, Windows, Linux, macOS, Web. - **Stack Principal:** 97.6% Dart/Flutter, con bindings en Rust y Go. - **Estado:** Versión **8.1.437** (actualizada hace 1 día). - **Comunidad:** 4 ⭐ Stars | 1 Fork (proyecto pequeño/nicho o nuevo).

---

### 🏗️ Arquitectura Técnica

Watchtower utiliza una arquitectura híbrida que combina Dart con lenguajes de sistema para rendimiento crítico:

1. **UI y Lógica (Dart/Flutter):** - **UI:** Modularizada por tipo de medio (anime, manga, música, player). - **Estado:** Riverpod 3.x. - **Navegación:** GoRouter 17.x. - **Base de Datos Local:** Isar (fork comunitario). - **Preferencias:** Hive 2.x.

2. **Motor de Extensiones (JS/QuickJS):** - Las fuentes de contenido no están hardcodeadas; se cargan dinámicamente. - Utiliza **QuickJS** vía FFI para ejecutar plugins JavaScript personalizados. - Permite a la comunidad crear fuentes para cualquier sitio.

3. **Capas de Sistema (Rust y Go):** - **Rust:** Gestiona operaciones de bajo nivel como lectura de EPUBs, procesamiento de imágenes y configuración de TLS personalizado (anti-bot). Usa `flutter_rust_bridge`. - **Go:** Ejecuta el cliente **BitTorrent** y el servidor de streaming HTTP. Permite descargar y ver contenido simultáneamente.

4. **Servidor Embebido:** - Incluye un servidor HTTP ligero (basado en `shelf`) en el puerto **4567** para comunicación interna o integración externa.

---

### 🚀 Características Principales

#### 1. 📺 Consumibilidad Multimedia - **Anime y Series:** Streaming multi-fuente con reproductor integrado (`media_kit`). - **Manga y Novelas:** Lectura offline, soporte de capítulos y marcadores. - **Música:** Reproductor audio con playlists y fuentes JS. - **Torrenting:** - Client BitTorrent nativo en Go. - Streaming HTTP de torrents: comienza a ver antes de descargar el archivo completo.

#### 2. 🧩 Sistema de Extensiones (JS Plugins) - **Extensibilidad Total:** Las fuentes se definen en scripts JS. - **Gestión:** Listado, validación y prueba de plugins. - **Seguridad:** Rotación de User-Agent y TLS personalizado para evadir bloqueos básicos.

#### 3. 🖥️ Modo Headless (CLI) - **Uso en Servidores:** Binario para Linux sin interfaz gráfica (sin X11/Wayland). - **Automatización:** Ideal para CI/CD, servidores SSH o scripts de automatización. - **Funciones CLI:** - `watchtower --cli extensions`: Listar, validar y probar fuentes. - `watchtower --cli source`: Buscar, inspeccionar y filtrar contenido por ID. - `watchtower --cli doctor`: Diagnóstico de salud del runtime. - Soporte para filtros de idioma (`--lang fr`) y contenido no indexado.

#### 4. 🌐 Cross-Platform y Web - **Aplicación Nativa:** Compilaciones optimizadas para Android (arm64), Windows y Linux. - **Web:** Versión alojada en Vercel (`watchtower-website-zeta.vercel.app`) para acceso desde navegador.

---

### 📥 Instalación y Build

#### Descargas Pre-compiladas - **Android:** Debug, Profile o Release APKs vía GitHub Actions. - **Desktop:** Windows x64 o Linux Headless (.7z). - **Web:** Acceso directo desde el sitio oficial.

#### Build Local Requiere Flutter 3.38+, Dart 3.10+, JDK 17+ y Android SDK (para móvil).

```bash git clone https://github.com/ferelking242/watchtower.git cd watchtower flutter pub get

# Desarrollo flutter run

# Android Release flutter build apk --release --target-platform android-arm64

# Windows/Linux Desktop flutter build windows flutter build linux ```

#### Instalación Headless Linux ```bash # Descargar el .7z desde GitHub Actions 7z x watchtower-linux-x64-headless.7z -o./watchtower-linux sudo ./watchtower-linux/install-linux-headless.sh ./watchtower-linux ```

---

### ⚠️ Limitaciones Actuales del CLI - El modo Headless **no inicializa** las bases de datos locales (Isar/Hive) de la app. - Comandos como `library`, `history`, `progress` o `download queue` **no están disponibles** en la CLI. - Solo expone operaciones de descubrimiento: fuentes, búsqueda, filtros, detalles y validación de plugins.

---

### 💡 Perfil de Usuario

Watchtower está dirigido a: 1. **Usuarios de Linux/Servidores:** Que quieren automatizar la descarga/streaming de anime/manga sin interfaz gráfica. 2. **Entusiastas de la Autogestión:** Que prefieren fuentes JS personalizables sobre catálogos cerrados. 3. **Usuarios Multiplataforma:** Que buscan una sola aplicación para Android, PC y Web con sincronización de estado (si se implementa en el futuro, aunque la CLI actual no soporta estado local).

Es una alternativa técnica a apps como **Stremio** o **Tachiyomi**, pero con un enfoque más en la **programación de fuentes JS** y la **integración nativa de Torrenting**.