Boorusphere

## 📱 Boorusphere: Visor de Booru para Android

**Boorusphere** es una aplicación de código abierto para Android diseñada para ser un visor de *booru* (plataformas de intercambio de imágenes etiquetadas como Danbooru, Gelbooru, etc.) simple, centrado en el contenido y respetuoso con la privacidad. Es un *fork* del proyecto original de [nullxception/boorusphere](https://github.com/nullxception/boorusphere).

### 🏷️ Información General - **Autor:** [azrim](https://github.com/azrim) - **Licencia:** BSD 3-Clause License - **Tecnología:** Desarrollada en **Flutter/Dart** (arquitectura limpia con Riverpod para el estado). - **Requisitos:** Android 7.0 (API 24) o superior. - **Estrellas:** 22 ⭐ | **Forks:** 1 - **Lenguajes:** 98.5% Dart, 1.2% Kotlin.

---

### ✨ Características Principales

1. **Grid Informativo ("A grid that talks"):** - Cada tarjeta en la cuadrícula muestra puntuación, clasificación (rating), formato y dimensiones antes de abrir la imagen. - Incluye sugerencias del tablero y un historial de búsquedas con opción de deshacer.

2. **Visor Minimalista ("A viewer that leaves the room"):** - Al tocar, la interfaz (chrome) y las barras del sistema desaparecen para una experiencia inmersiva. - Gestos personalizables: zoom con pellizco/doble toque, navegación horizontal/vertical, deslizamiento para ver detalles o descartar.

3. **Soporte Multimedia:** - Reproducción inline de videos e imágenes animadas. - Soporte para *slideshows* (adelante, atrás o aleatorio) con intervalos configurables. - Manejo avanzado de encabezados `Referer` y `User-Agent` para sitios que los requieren.

4. **Bloqueo de Etiquetas (Tags Blocker):** - Soporta expresiones lógicas: espacio (AND), `~` (OR), `-` (excluir). - Indicador claro cuando una página está vacía por filtros, con opción de restaurarla. - Opción de difuminar (blur) miniaturas explícitas.

5. **Gestión por Lotes (Batches):** - Selección múltiple mediante pulsación larga para favoritar, descargar o compartir. - Hoja de detalles dividida en información, etiquetas y enlaces. - Función "Encontrar relacionados" que usa las etiquetas de la imagen para generar nuevas búsquedas.

6. **Descargas Robustas:** - Pausar, reanudar y reintentar (individual o masivamente). - Hasta 4 descargas simultáneas. - Archivos guardados en `Downloads/Boorusphere/` con registros laterales (sidecar) del post original. - Opción para excluir la colección de la galería de Android.

7. **Compatibilidad con Múltiples Tableros:** - 10 presets incluidos: Danbooru, Gelbooru, Konachan, Yandere, Safebooru, Rule34, e621, Derpibooru, Ponybooru y Rule34 Paheal. - Soporte para motores personalizados: Danbooru, Gelbooru (0.1.x/0.2), Moebooru, e621, Shimmie, Szurubooru, Philomena. - Escaneo automático para detectar el motor del sitio.

8. **Privacidad y Seguridad:** - **Sin cuentas, sin analíticas, sin servidores propios.** - Bloqueo con PIN/biométricos con protección contra intentos de adivinanza. - Opción para ocultar la app de la lista de recientes y bloquear capturas de pantalla. - Gestión de caché con límites configurables para videos (100MB a 1GB).

9. **Personalización:** - Temas: Claro, Oscuro, Sistema o **Midnight** (negro puro para OLED). - Colores derivados del fondo de pantalla (Android 12+), Material You o paletas predefinidas. - Diseño *edge-to-edge* con soporte para pantallas de alta tasa de refresco.

10. **Copias de Seguridad:** - Archiva configuración, servidores, historial, etiquetas bloqueadas y favoritos. - Opción de encriptar con contraseña. - Programación de envíos automáticos a un bot de Telegram propio.

---

### 📥 Instalación

No está disponible en Google Play Store. Se instala manualmente (*sideload*) desde los [Releases](https://github.com/azrim/boorusphere/releases) del repositorio.

| APK | Uso recomendado | |-----|----------------| | `arm64-v8a` | Casi todos los teléfonos desde 2017 (por defecto). | | `armeabi-v7a` | Teléfonos antiguos de 32 bits. | | `x86_64` | Emuladores y Chromebooks x86_64. | | `universal` | Archivo único para todos (solo para primera instalación). |

> **Nota:** El actualizador interno de la app descarga el APK correcto para tu arquitectura. Si descargas manualmente, asegúrate de que la variante coincida con la instalada previamente.

---

### 🛠️ Para Desarrolladores

- **Stack:** Flutter 3.44.0+ / Dart 3.12+. - **Estructura:** - `lib/presentation`: UI y estado (Riverpod). - `lib/domain`: Interfaz de repositorios. - `lib/data`: Implementaciones y parsers de booru. - **Comandos clave (usando `grinder`):** - `grind gencode`: Regenerar código generado. - `grind genlang`: Regenerar strings y reportar traducciones faltantes. - `grind pigeons`: Regenerar bindings de canal de plataforma. - `grind chkfmt` / `analyze` / `test`: Verificación de calidad de código (requerido para PRs).

---

### 🌍 Idiomas y Comunidad

- **Idiomas soportados:** Alemán, Filipino, Indonesio, Japonés, Ruso, Tailandés, Turco, Ucraniano, Chino Simplificado y Tradicional, e incluso "uwu". - Las claves no traducidas vuelven al inglés, por lo que se aceptan traducciones parciales. - 15 contribuidores reconocidos en el repositorio.

---

### ❓ FAQ Destacada

- **¿Recopila datos?** No. Todo se queda en tu dispositivo. Las únicas excepciones son las descargas voluntarias a tu bot de Telegram. - **¿Por qué una página está vacía?** Probablemente por el filtro de clasificación o el bloqueador de etiquetas. La app indica cuál fue el culpable y permite desactivarlo. - **¿Cómo añado un booru no listado?** Añade la URL; la app intenta detectarlo automáticamente o puedes elegir el motor manualmente.

Boorusphere se posiciona como una alternativa ligera, privada y completamente personalizable para usuarios de Android que interactúan con plataformas booru.