Foxlations

## 🦊 Foxlations: Lector Multi-Media Multiplataforma con Sistema de Extensiones

**Foxlations** es una aplicación de código abierto desarrollada en **Flutter**, diseñada para leer manga, manhwa, novelas ligeras y videos. A diferencia de otros lectores, destaca por su soporte nativo para **iOS** (mediante sideloading) y su arquitectura basada en **extensiones**, permitiendo a los usuarios añadir sus propias fuentes de contenido y repositorios locales.

### 🏷️ Información General - **Autor:** [Lill Q (@ghotato)](https://github.com/ghotato) - **Licencia:** Apache 2.0 - **Stack Tecnológico:** 95.9% Dart (Flutter), con bindings nativos en Kotlin (Android) y Swift (iOS). - **Plataformas:** Android, iOS, Windows. - **Estado:** Versión **1.2.2+188** (actualizada hace 1 mes). - **Privacidad:** Estricta. Sin cuentas, sin analíticas, sin servidor central. Todo el procesamiento (incluida la IA) es local o controlado por el usuario.

---

### 🚀 Características Principales

#### 1. 📚 Lectura y Gestión de Contenido - **Formatos Soportados:** Manga, Manhwa, Novelas Ligeras y Video. - **Sistema de Extensiones:** - No incluye fuentes de contenido por defecto ("ships no sources"). - Los usuarios deben añadir sus propias fuentes o repositorios locales. - Permite extender la funcionalidad mediante plugins. - **Sincronización Externa:** - Integración opcional con **AniList**, **MyAnimeList** y **Kitsu** para sincronizar el progreso de lectura/vista. - Los tokens se encriptan localmente y solo se envían a los servicios de terceros.

#### 2. 🤖 IA y Traducción (Control del Usuario) - **Traducción por IA:** - Funcionalidad opcional y desactivada por defecto. - Requiere que el usuario proporcione su propia **API Key**. - Las imágenes se envían directamente al proveedor de IA elegido; Foxlations no actúa como intermediario ni almacena datos. - **Reconocimiento de Texto (OCR):** - Soporte para reconocimiento de texto en el dispositivo (on-device), sin necesidad de conexión a internet. - **Text-to-Speech (TTS):** - Funcionalidad de lectura en voz alta, desarrollada con asistencia de IA durante el proyecto.

#### 3. 📱 Multiplataforma y Distribución - **Android:** - APKs firmados para arm64. - Actualizaciones instalables directamente sobre la versión anterior (mantiene datos). - **iOS:** - Build `.ipa` sin firmar. - Diseñado para **sideloading** mediante **AltStore/SideStore** (refresco automático vía Wi-Fi para evitar expiración de 7 días) o **Sideloadly**. - Compatible con **TrollStore** para instalación permanente en dispositivos soportados. - **Windows:** - Disponible vía GitHub Releases.

#### 4. 🔒 Privacidad y Transparencia - **Sin Rastreo:** No hay cuenta de usuario ni analíticas. - **Cálculo Local:** La página de "Stats" (tiempo de lectura, capítulos leídos) se calcula exclusivamente en el dispositivo. - **Actualizaciones:** La única petición de red automática es verificar si existe una nueva versión en `lillq.me/foxlations`. El servidor solo ve la IP, no los datos de la librería. - **Backup/Restore:** Gestión de copias de seguridad de la librería local.

---

### 🛠️ Arquitectura Técnica

- **Core:** Flutter 3.x (Dart). - **Android:** Uso de Kotlin y JVM para ejecutar extensiones si estas son de tipo JVM (una limitación técnica superada con ayuda de IA). - **iOS:** Bindings en Swift/Objective-C para interoperabilidad nativa. - **Gestión de Estado/UI:** Estándar de Flutter. - **Internacionalización:** Soporte para Inglés, Español, Portugués, Francés, Alemán, Italiano, Japonés, Chino y Árabe. Traducciones gestionadas mediante **Weblate**.

---

### 📥 Instalación

1. **Android:** - Descargar `foxlations-<version>-arm64.apk` desde [Releases](https://github.com/Foxlations/Foxlations/releases) o `lillq.me/foxlations`. - Instalar permitiendo orígenes desconocidos.

2. **iOS:** - Descargar `foxlations-<version>.ipa`. - Usar **AltStore** (requiere PC/Mac inicial) o **SideStore** (todo en dispositivo). - Conectar Apple ID gratuito, instalar y "Trust" el perfil en Ajustes. - *Nota:* Las apps con ID gratuito expiran cada 7 días si no se usan herramientas de refresco como AltStore.

---

### 💡 Perfil de Usuario y Consideraciones

- **Desarrollador Independiente:** Es un proyecto de una sola persona que trabaja a tiempo completo. Las actualizaciones pueden ser lentas, pero los issues se revisan. - **Para Usuarios de iOS:** Es una de las pocas alternativas de lectores de manga/manhwa de código abierto que ofrecen un build nativo para iOS (aunque requiere sideloading). - **Para Puristas de la Privacidad:** Ideal para usuarios que no quieren subir su biblioteca de lectura a ningún servidor central, ni usar cuentas creadas por el desarrollador. - **Comunidad:** Se gestiona principalmente vía **Discord** para soporte y solicitudes.

Foxlations se posiciona como una alternativa ligera, privada y flexible a gigantes como Tachiyomi/Mihon, con la ventaja única de soportar **iOS nativamente** (vía sideload) y ofrecer un control total sobre la traducción por IA y las fuentes de contenido.