Organizando tu colección local de videos con JavBoss

Mucha gente tiene gigabytes de videos, películas o contenido de nicho acumulando polvo en servidores domésticos o discos externos. Los nombres de archivo como IPX-633.mp4 o SSIS-001.mkv no te dicen mucho cuando quieres encontrar rápidamente un clip de video específico o consultar el perfil de una actriz. Los servidores multimedia completos como Plex o Jellyfin a menudo tienen dificultades con los lanzamientos asiáticos de nicho: simplemente no pueden analizar códigos como IPX-633 ni obtener imágenes de portada adecuadas.

Hace poco me encontré con un interesante proyecto de código abierto en GitHub llamado JavBoss. Es un servidor web local construido con Go y React, diseñado específicamente para indexar, catalogar y visualizar cómodamente contenido JAV y grabaciones de video arbitrarias.

Cómo funciona el sistema de catalogación

El autor abordó la tarea desde una perspectiva práctica de usabilidad. La aplicación funciona como un servicio web local: escanea directorios específicos, extrae códigos de los nombres de archivo, obtiene metadatos de varias bases de datos externas y construye una galería clara.

La característica principal es la autonomía completa de tus archivos. JavBoss funciona en modo solo lectura. No renombra los archivos de video originales ni satura tus carpetas de video con archivos NFO o imágenes. La base de datos SQLite, la caché de portadas y los storyboards se almacenan estrictamente en el directorio data/.

Desglose de las características principales

Veamos lo que diferencia a este proyecto de los raspadores convencionales de línea de comandos.

1. Análisis automático de códigos y metadatos. La aplicación extrae códigos en formato IPX-633, SSIS-001 o sufijos de subtítulos. Los metadatos se obtienen de múltiples fuentes de terceros simultáneamente. Las tarjetas incluyen títulos, fechas de lanzamiento, estudios, etiquetas y medidas de las actresses (altura, edad, dimensiones). Si la detección automática comete un error, puedes vincular fácilmente una tarjeta manualmente.

2. Integración con el reproductor mpv. Los reproductores web multimedia a menudo están limitados por los códecs del navegador. Los desarrolladores de JavBoss encontraron una solución sencilla: la versión de escritorio puede invocar directamente mpv local. Obtienes un reproductor completo con soporte para cualquier formato de video, teclas de acceso rápido personalizables y la interfaz ModernZ. Mientras ves en mpv, puedes tomar capturas de pantalla con un solo botón, y aparecerán inmediatamente en la línea de tiempo del video en la interfaz web.

3. Seguimiento de reubicación de archivos. El indexador monitorea los directorios agregados en segundo plano. ¿Moviste un archivo a otra unidad o renombraste una carpeta? La base de datos actualiza las rutas. Las etiquetas de usuario se preservan porque están vinculadas a la huella digital del archivo de video. Si desconectas un disco duro externo, las tarjetas permanecen en la base de datos, y cuando reconectes la unidad, se activan nuevamente.

4. Navegación y filtrado. Puedes encontrar videos por etiquetas, estudios, actresses o fecha de lanzamiento. Hay una práctica función de selección aleatoria que funciona en toda tu biblioteca multimedia o dentro de un conjunto específico de filtros.

La interfaz se ve clara y no está saturada de menús innecesarios:

Stack tecnológico y despliegue

La arquitectura del proyecto es limpia. El backend está escrito en Go usando el framework Gin, GORM y la base de datos SQLite integrada. Se usa ffprobe para leer los parámetros técnicos del video, mientras que las vistas previas y los storyboards se generan a través de mpv o ffmpeg.

El frontend está construido con React, Vite, Tailwind CSS y Zustand. Por defecto, el servicio se ejecuta en el puerto 8655. Puedes instalarlo con un script automatizado, descargando un binario o a través de Docker Compose:

services:
  javboss:
    image: ghcr.io/solr159/javboss:latest
    container_name: javboss
    ports:
      - "8655:17654"
    volumes:
      - ./data:/app/data
      - /:/host:ro
    restart: unless-stopped

En el contenedor, los videos se reproducen a través del reproductor HTML5 integrado en el navegador, y las rutas locales del sistema host se reenvían automáticamente.

Ventajas y consideraciones específicas

Esta herramienta será útil para cualquiera que mantenga una colección local y esté cansado del caos en su sistema de archivos.

Puntos fuertes del proyecto:

• Cero interferencia con la estructura de carpetas original.
• Transferencia simple de la base de datos entre sistemas mediante una copia directa de data/.
• Uso de múltiples fuentes para la agregación de metadatos.
• Interfaz web conveniente con soporte para abrir páginas en diferentes pestañas del navegador.

Hay algunas limitaciones a considerar. La importación inicial de una colección grande llevará tiempo para la generación de vistas previas en segundo plano y la descarga de portadas. Si los sitios externos de metadatos no están disponibles, el raspado automático se pausará, aunque la base de datos almacenada localmente continuará funcionando sin conexión.

Conclusión

JavBoss resultó ser una solución práctica y especializada. El autor no intentó construir otro sistema multimedia voluminoso, sino que resolvió un problema específico de catalogación de contenido de nicho. Si necesitas orden en tus unidades de disco sin trabajo manual extra, definitivamente vale la pena probar este proyecto.