AniZen Preview

## 🎋 AniZen: Cliente de Anime y Cine de Alto Rendimiento

**AniZen** es un proyecto *solo-built* (desarrollado por una sola persona) para Android, enfocado en ofrecer una experiencia de visualización premium, fluida y altamente personalizable. Está construido sobre las bases de **Aniyomi** y **Anikku**, pero se distingue por su uso intensivo de **Jetpack Compose**, motores de video avanzados (**MPV**) y shaders de upscaling en tiempo real (**Anime4K**).

### 🏷️ Información General - **Autor:** [salmanbappi](https://github.com/salmanbappi) - **Licencia:** Apache 2.0 - **Stack Tecnológico:** 91.6% Kotlin, 7.9% GLSL (Shaders), Jetpack Compose. - **Base:** Aniyomi / Anikku (Línea Tachiyomi/Mihon). - **Requisitos:** Android moderno (recomendado hardware capaz de decodificación acelerada). - **Estado:** Versión **v0.5.220** (actualizada hace 2 semanas). - **Paquete:** `app.anizen` (coexiste con Anikku/Aniyomi).

---

### 🎬 Motor de Video y Reproducción (Lo más distintivo)

AniZen no usa el reproductor estándar de Android, sino que integra una capa avanzada sobre **MPV** y shaders personalizados:

1. **Anime4K Neural Shaders:** - Upscaling en tiempo real con niveles de calidad: *Fast, Balanced, High*. - Múltiples modos de procesamiento (A, B, C, A+, B+, C+) para nitidez y reducción de ruido. - **Adaptive Shader Scaling:** Si detecta *frame drops*, reduce automáticamente la calidad del shader para mantener la fluidez. 2. **Interpolación de Movimiento:** - Generación de frames intermedios para sincronizar la tasa de refresco (hasta 120Hz/144Hz). - Algoritmos: *oversample, mitchell, catmull-rom*. 3. **MPVFX Filter Suite:** - Interfaz basada en tarjetas para ajustes avanzados: *Debanding*, Brillo, Saturación, Contraste, Gamma, Matiz, Nitidez. - Control total de Anime4K integrado en el player. 4. **Dynamic Mediacodec Switching:** - Cambio automático entre decodificación hardware y software si los filtros exceden la capacidad del hardware. 5. **Gestión de Audio:** - **Volume Boost:** Hasta 200% con corrección de pitch (mantiene la voz natural a altas velocidades/volúmenes). 6. **Interacciones Fluidas:** - **Pinch-to-Zoom:** Hasta 3x con ajustes precisos. - **Jitter-free 2x Speed:** Presión larga para velocidad 2x sin tartamudeo. - **PiP Nativo:** Picture-in-Picture con controles personalizados. - **Subtítulos On-Demand:** Carga de archivos externos (VTT, ASS, SRT) durante la reproducción. - **MPV Config Editor:** Editor de código en-app para modificar `mpv.conf` e `input.conf` y ejecutar scripts personalizados.

---

### 📥 Descarga y Almacenamiento Resiliente

El motor de descargas está diseñado para robustez y eficiencia:

1. **Motor Multi-hilo (1DM-Style):** - Descarga por fragmentos (*chunked*) usando rangos de bytes. - Recuperación de archivos parciales con verificación de tamaño y reintentos exponenciales (x5). 2. **Soporte HLS & DASH Nativo:** - Descarga de segmentos HLS con desencriptación AES-128 en tiempo real. - Muxing nativo de DASH vía FFmpeg con estimación de progreso basada en duración. 3. **Pre-fetching Proactivo:** - Resuelve enlaces de streams en segundo plano para la siguiente descarga, minimizando retrasos. 4. **Gestión de Subtítulos:** - Descarga y empaquetado automático de subtítulos (VTT, ASS, SRT) junto al video. 5. **Protección de Almacenamiento:** - Verificación de espacio antes de descargar (buffer de seguridad de 200MB o 1.5x para FFmpeg). - Descargas atómicas en carpetas temporales (`_tmp`) para evitar archivos corruptos en almacenamiento público. 6. **Handoff a Descargadores Externos:** - Delegación a apps como 1DM/ADM, pasando headers personalizados y rutas.

---

### 📰 Feed y Personalización Visual

- **Temas Dinámicos:** - Colores de la interfaz y del player extraídos automáticamente del arte de portada de la serie. - 22 paletas de color predefinidas. - Efecto **Haze Glassmorphism** (desenfoque) en barras de navegación. - **Feed Personalizado:** - **Category-Styled Feeds:** Organiza búsquedas guardadas y populares en secciones arrastrables. - **Saved Search Feeds:** Fija consultas de búsqueda como filas de feed auto-actualizables. - **Unified Feed Tab:** Combina múltiples fuentes en una sola vista. - **Organización:** - Carpetas de biblioteca colapsables. - Estilos de contenedor de tarjetas personalizables por pestaña. - Portadas panorámicas (*Panorama cover*).

---

### 📊 Estadísticas, Diagnóstico y Mantenimiento

- **Behavioral Watch Statistics:** - Heatmaps semanales, afinidad por género, desglose de estados, logs de actividad de 30 días, horarios preferidos. - Métricas de infraestructura: latencia, throughput, topología de red. - **AI Diagnostics & Assistant:** - Asistente conversacional que analiza logs de excepciones y contexto de la biblioteca para solucionar problemas. - **Extension Health Monitoring:** - Reporte en tiempo real de latencia de extensiones, estado de nodos y métricas de conexión. - **Adaptive Navigation:** - Sugerencia de presets de layout (Default, Minimal, Power) basada en conectividad y hora del día.

---

### 🛠️ Arquitectura Técnica

- **Clean Architecture:** Separación estricta en `app`, `core`, `data`, `domain`, `presentation-core`, `source-api`. - **UI:** 100% **Jetpack Compose**. - **Concurrencia:** Kotlin Coroutines & Flow. - **Base de Datos:** **SQLDelight** (consultas SQL seguras en tiempo de compilación). - **Optimización de Scroll:** Uso de `Precision.INEXACT` para delegar el escalado de imágenes a la GPU, eliminando micro-tirones en pantallas de 120/144Hz.

---

### 📥 Instalación

1. Descargar el APK `arm64-v8a` desde [Releases](https://github.com/salmanbappi/AniZen/releases). 2. Instalar (requiere permisos de origen desconocido). 3. El paquete `app.anizen` permite coexistir con Anikku/Aniyomi (no requiere desinstalarlos). 4. También disponible vía GitHub Actions para builds de preview.

---

### 💡 Perfil de Usuario

AniZen es ideal para usuarios que: 1. **Priorizan la Calidad de Video:** Quieren upscaling (Anime4K) e interpolación de movimiento para ver anime en 120Hz con la máxima nitidez posible. 2. **Son Técnicos:** Les interesa configurar `mpv.conf`, usar scripts personalizados y entender las métricas de rendimiento de sus extensiones. 3. **Buscan Fluidez Extrema:** La implementación de Compose y la gestión de GPU para scrolls hacen que la app se sienta más "nativa" y rápida que otras basadas en XML. 4. **Consumen Anime/Movie:** Es un cliente específico para video, no para manga/novelas (a diferencia de Mihon/Reikai).

Es una evolución sofisticada de la línea Aniyomi, orientada puramente al **video** y la **experiencia visual**, sacrificando la versatilidad multi-media por la profundidad de funciones en el reproductor.