Organizzare la tua collezione video locale con JavBoss

Molte persone hanno gigabyte di video, film o contenuti di nicchia che raccolgono polvere su server domestici o dischi esterni. Nomi di file come IPX-633.mp4 o SSIS-001.mkv non dicono molto quando vuoi trovare rapidamente un clip video specifico o consultare il profilo di un'attrice. I server multimediali completi come Plex o Jellyfin spesso faticano con le uscite asiatiche di nicchia: semplicemente non riescono a interpretare codici come IPX-633 o a recuperare le copertine corrette.

Recentemente ho scoperto un interessante progetto open-source su GitHub chiamato JavBoss. È un server web locale costruito con Go e React, progettato specificamente per indicizzare, catalogare e visualizzare comodamente contenuti JAV e registrazioni video arbitrarie.

Come funziona il sistema di catalogazione

L'autore ha affrontato il problema da un punto di vista pratico di usabilità. L'applicazione funziona come un servizio web locale: analizza le directory specificate, estrae i codici dai nomi dei file, recupera i metadati da diversi database esterni e costruisce una galleria chiara.

La caratteristica principale è la completa autonomia dai tuoi file. JavBoss funziona in modalità sola lettura. Non rinomina i file video sorgente né intasa le tue cartelle video con file NFO o immagini. Il database SQLite, la cache delle copertine e le storyboard sono archiviati rigorosamente nella directory data/.

Analisi delle funzionalità principali

Vediamo cosa distingue questo progetto dai tradizionali scraper da riga di comando.

1. Parsing automatico dei codici e dei metadati. L'applicazione estrae i codici nel formato IPX-633, SSIS-001 o suffissi dei sottotitoli. I metadati vengono recuperati da più fonti di terze parti simultaneamente. Le schede includono titoli, date di uscita, studi, tag e misure delle attrici (altezza, età, dimensioni). Se il rilevamento automatico commette un errore, puoi facilmente collegare una scheda manualmente.

2. Integrazione con il player mpv. I player multimediali web sono spesso limitati dai codec del browser. Gli sviluppatori di JavBoss hanno trovato una soluzione semplice: la versione desktop può invocare direttamente mpv locale. Ottieni un player completo con supporto per qualsiasi formato video, tasti di scelta rapida personalizzabili e l'interfaccia ModernZ. Mentre guardi in mpv, puoi scattare screenshot con un singolo pulsante, e appariranno immediatamente sulla timeline del video nell'interfaccia web.

3. Tracciamento dello spostamento dei file. L'indicizzatore monitora le directory aggiunte in background. Hai spostato un file su un altro disco o rinominato una cartella? Il database aggiorna i percorsi. I tag utente vengono preservati perché sono legati all'impronta digitale del file video. Se scolleghi un disco rigido esterno, le schede rimangono nel database, e quando ricolleghi il disco, diventano di nuovo attive.

4. Navigazione e filtraggio. Puoi trovare i video per tag, studi, attrici o data di uscita. C'è una comoda funzione di selezione casuale che funziona su tutta la tua libreria multimediale o all'interno di un set specifico di filtri.

L'interfaccia appare chiara e non è ingombra di menu inutili:

Stack tecnico e deployment

L'architettura del progetto è pulita. Il backend è scritto in Go usando il framework Gin, GORM e database SQLite integrato. ffprobe viene usato per leggere i parametri tecnici dei video, mentre le anteprime e le storyboard vengono generate attraverso mpv o ffmpeg.

Il frontend è costruito con React, Vite, Tailwind CSS e Zustand. Di default, il servizio gira sulla porta 8655. Puoi installarlo con uno script automatizzato, scaricando un binario o tramite 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

Nel container, i video vengono riprodotti attraverso il player HTML5 integrato nel browser, e i percorsi locali dal sistema host vengono inoltrati automaticamente.

Punti di forza e considerazioni specifiche

Questo strumento sarà utile per chiunque gestisca una collezione locale e sia stanco del caos nel proprio file system.

Punti di forza del progetto:

• Nessuna interferenza con la struttura delle cartelle originale.
• Semplice trasferimento del database tra sistemi tramite la diretta copia della data/.
• Utilizzo di più fonti per l'aggregazione dei metadati.
• Interfaccia web comoda con supporto per l'apertura delle pagine in diverse schede del browser.

Ci sono alcune limitazioni da considerare. L'importazione iniziale di una vasta collezione richiederà tempo per la generazione delle anteprime in background e il download delle copertine. Se i siti di metadati esterni non sono disponibili, lo scraping automatico si fermerà, sebbene il database archiviato localmente continuerà a funzionare offline.

Conclusione

JavBoss si è rivelato essere una soluzione pratica e specializzata. L'autore non ha cercato di costruire un altro sistema multimediale ingombrante, ma ha risolto un problema specifico di catalogazione di contenuti di nicchia. Se hai bisogno di ordine sui tuoi dischi senza lavoro manuale extra, questo progetto merita sicuramente di essere provato.