Yugen

## 🔄 DeepSync: Ecosistema Multiplataforma de Lectura y Visualización

**DeepSync** es el nombre del **proyecto principal**, no de la aplicación en sí. Este proyecto busca unificar la experiencia de lectura de manga, novelas ligeras y visualización de anime a través de aplicaciones nativas para diferentes plataformas, cada una con su propio nombre e identidad, pero compartiendo la misma base de código y filosofía.

### 🏷️ Estructura de Nombres (Crucial)

| Nombre de la App | Plataforma | Estado | | :--- | :--- | :--- | | **Yugen** | **Android** | **Disponible (v0.1.0)** | | *Shinkai* | Linux | Próximamente | | *Yomi* | Windows | Próximamente |

*Nota: Este repositorio contiene específicamente **Yugen**, la versión para Android.*

---

### 📱 Yugen: Características Principales (Android)

Yugen es un fork de **DropSauce** (que a su vez viene de Kotatsu). Se distingue por una rediseñada experiencia de usuario y funcionalidades específicas para novelas.

#### 1. 📖 Lector de Novelas Ligeras Avanzado (Full Novel Reader) - **Reconstrucción Completa:** Nuevo motor de lectura con estilos de scroll, presets visuales, fondos personalizados. - **Text-to-Speech (TTS):** Integración nativa de lectura en voz alta. - **Formatos:** Soporte para importación offline de EPUBs. - **Formato LNReader:** Soporte para plugins JS bajo el formato LNReader.

#### 2. 🎨 Diseño Material 3 Expressive - **UI Rediseñada:** Identidad visual propia ("Yugen identity"). - **Feedback Tátil:** Efectos de pulsación ("pulse touch feedback") en lugar de las ondas tradicionales de Material Design. - **Home Personalizable:** - Estilos de banner cambiables. - Carriles intercambiables. - **Live Layout Preview:** Vista previa en tiempo real de los cambios de layout. - **Colores Dinámicos:** Acentos que siguen el tema global de la app.

#### 3. 📊 Gestión de Biblioteca y Rastreadores (Trackers) - **Rastreadores Soportados:** AniList, MyAnimeList (MAL), MangaBaka. - **Sync Library:** Biblioteca sincronizada donde el progreso más avanzado gana automáticamente. - **Metadata Source Picker:** El usuario puede elegir la fuente de metadatos para series con nombres similares. - **Tracker Matching Inteligente:** Diferencia entre títulos con nombres idénticos pero distintas obras. - **Páginas de Detalles:** Información extendida de trackers integrada.

#### 4. 🎬 Sección de Anime - **Watch Page:** Página dedicada para anime con notas personales. - **Auto-picked Streams:** Selección automática de streams. - **Player Settings:** Página específica de configuración del reproductor de anime.

#### 5. ⚙️ Motor de Extensiones Híbrido - Soporta **LNReader JS Plugins**. - Soporta extensiones basadas en APKs externas como **Tsundoku** y **Mihon** (vía integración `mihon/`).

---

### 🛠️ Arquitectura Técnica

- **Lenguaje:** 100% Kotlin. - **Base:** Kotatsu / DropSauce. - **Paquete:** `com.kotatsu.deepsync` (permite coexistir con DropSauce original). - **Estructura de Directorios Clave:** - `app/src/main/kotlin/org/koitharu/kotatsu/`: - `reader/`: Lógica de lectura manga/novela. - `lnreader/`: Integración de plugins LNReader. - `scrobbling/`: Integración con trackers (AniList, MAL, MangaBaka). - `home/`: Gestión del feed y carouseles. - `anime/`: Lógica específica para visualización de anime. - `backup/`: Copias de seguridad locales y restauración (compatible con Kotatsu/Mihon).

---

### 📥 Instalación y Actualización

1. **Descarga:** APK desde los [Releases](https://github.com/Arthurpendragon9876/DeepSync/releases) de GitHub. 2. **Instalación:** Requiere permisos de "Orígenes Desconocidos". 3. **Actualizaciones:** - Manual descargando el nuevo APK. - In-app: La app tiene un sistema de actualización interna habilitado. 4. **Copias de Seguridad:** Soporta restauración de backups de **Kotatsu** y **Mihon**.

---

### 🆚 Diferencias con DropSauce (Base)

Yugen añade sobre DropSauce: 1. Lector de novelas reconstruido con TTS. 2. Home rediseñado con previews en vivo. 3. Sistema de emparejamiento de trackers más robusto. 4. Interfaz de anime con notas y selección de streams. 5. Nueva identidad visual (pulse feedback, M3 Expressive).

---

### ⚖️ Licencia y Legalidad

- **Licencia:** GPL-3.0 (La app es libre y de código abierto, pero cualquier derivado debe mantener esta licencia). - **Contenido:** **No aloja contenido.** No incluye fuentes ni sitios de streaming por defecto. El usuario debe añadir sus propias extensiones, repositorios o archivos locales. - **Sin Afiliación:** No afiliado con los proveedores de contenido.

---

### 💡 Perfil de Usuario

DeepSync (Yugen) es ideal para usuarios que: 1. **Quieren un solo app para todo:** Manga, Novelas y Anime, con UI unificada y moderna. 2. **Leen Novas Ligeras Frecuentemente:** El lector de novelas es su punto fuerte, con TTS y personalización avanzada. 3. **Valorian la Estética:** El diseño Material 3 Expressive y el feedback táctil único ofrecen una experiencia visual superior a las apps base. 4. **Usan Linux/Windows en el futuro:** Si buscan una experiencia sincronizada y similar en escritorio, esperan las versiones *Shinkai* y *Yomi*.

Es un proyecto ambicioso que intenta consolidar el ecosistema de lectores Android en una suite multiplataforma coherente, liderada por la fortaleza de su lector de novelas y su diseño.