Ihre lokale Videosammlung mit JavBoss organisieren

Viele Menschen haben Gigabytes an Videos, Filmen oder Nischeninhalten, die auf Heimservern oder externen Festplatten verstauben. Dateinamen wie IPX-633.mp4 oder SSIS-001.mkv sagen einem nicht viel, wenn man schnell einen bestimmten Videoclip finden oder das Profil einer Darstellerin nachschlagen möchte. Vollständige Medienserver wie Plex oder Jellyfin haben oft Probleme mit Nischen-Asien-Releases: Sie können Codes wie IPX-633 einfach nicht parsen oder passende Cover-Bilder abrufen.

Kürzlich bin ich auf ein interessantes Open-Source-Projekt auf GitHub namens JavBoss gestoßen. Es ist ein lokaler Webserver, der mit Go und React entwickelt wurde und speziell für die Indexierung, Katalogisierung und komfortable Wiedergabe von JAV-Inhalten und beliebigen Videoaufnahmen konzipiert wurde.

So funktioniert das Katalogisierungssystem

Der Autor hat sich dem Problem aus praktischer Benutzerfreundlichkeit genähert. Die Anwendung funktioniert als lokaler Webservice: Sie scannt angegebene Verzeichnisse, extrahiert Codes aus Dateinamen, ruft Metadaten aus mehreren externen Datenbanken ab und erstellt eine übersichtliche Galerie.

Das Hauptmerkmal ist die vollständige Autonomie von Ihren Dateien. JavBoss läuft im Nur-Lesen-Modus. Es benennt Quellvideodateien nicht um und überlädt Ihre Videoordner nicht mit NFO-Dateien oder Bildern. Die SQLite-Datenbank, der Cover-Cache und die Storyboards werden strikt im Verzeichnis data/ gespeichert.

Die wichtigsten Funktionen im Detail

Schauen wir uns an, was dieses Projekt von herkömmlichen Kommandozeilen-Scrapern unterscheidet.

1. Automatische Code- und Metadaten-Parsing. Die Anwendung extrahiert Codes im Format IPX-633, SSIS-001 oder Untertitel-Suffixe. Metadaten werden gleichzeitig von mehreren Drittanbieter-Quellen abgerufen. Karten enthalten Titel, Veröffentlichungsdaten, Studios, Tags und Maße der Darstellerinnen (Größe, Alter, Maße). Wenn die automatische Erkennung einen Fehler macht, können Sie eine Karte einfach manuell verknüpfen.

2. mpv-Player-Integration. Web-Mediaplayer sind oft durch Browser-Codecs eingeschränkt. Die JavBoss-Entwickler fanden eine einfache Lösung: Die Desktop-Version kann lokalen mpv direkt aufrufen. Sie erhalten einen vollwertigen Player mit Unterstützung für jedes Videoformat, anpassbaren Hotkeys und der ModernZ-Oberfläche. Während Sie in mpv schauen, können Sie mit einer einzigen Taste Screenshots erstellen, die sofort auf der Videotimeline in der Weboberfläche erscheinen.

3. Datei-Verschiebungsverfolgung. Der Indexer überwacht hinzugefügte Verzeichnisse im Hintergrund. Haben Sie eine Datei auf ein anderes Laufwerk verschoben oder einen Ordner umbenannt? Die Datenbank aktualisiert die Pfade. Benutzer-Tags bleiben erhalten, da sie an den digitalen Fingerabdruck der Videodatei gebunden sind. Wenn Sie eine externe Festplatte trennen, bleiben die Karten in der Datenbank, und wenn Sie das Laufwerk wieder anschließen, werden sie wieder aktiv.

4. Navigation und Filterung. Sie können Videos nach Tags, Studios, Darstellerinnen oder Veröffentlichungsdatum finden. Es gibt eine praktische Zufallsfunktion, die über Ihre gesamte Medienbibliothek oder innerhalb eines bestimmten Filtersatzes funktioniert.

Die Oberfläche sieht übersichtlich aus und ist nicht mit unnötigen Menüs überladen:

Technischer Stack und Bereitstellung

Die Projektarchitektur ist sauber. Das Backend ist in Go unter Verwendung des Gin-Frameworks, GORM und der integrierten SQLite-Datenbank geschrieben. ffprobe wird zum Lesen technischer Videoparameter verwendet, während Vorschauen und Storyboards durch mpv oder ffmpeg generiert werden.

Das Frontend ist mit React, Vite, Tailwind CSS und Zustand aufgebaut. Standardmäßig läuft der Service auf Port 86. Sie können ihn mit einem automatisierten Skript installieren, durch Herunterladen einer Binärdatei oder über 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

Im Container werden Videos über den integrierten HTML5-Player im Browser abgespielt, und lokale Pfade vom Host-System werden automatisch weitergeleitet.

Vorteile und besondere Aspekte

Dieses Tool ist für jeden nützlich, der eine lokale Sammlung pflegt und des Chaos in seinem Dateisystem überdrüssig ist.

Stärken des Projekts:

• Keinerlei Eingriff in die ursprüngliche Ordnerstruktur.
• Einfache Datenbankübertragung zwischen Systemen durch unkompliziertes Kopieren von data/.
• Verwendung mehrerer Quellen für die Metadaten-Aggregation.
• Praktische Weboberfläche mit Unterstützung für das Öffnen von Seiten in verschiedenen Browser-Tabs.

Es gibt einige Einschränkungen zu beachten. Der erste Import einer großen Sammlung nimmt Zeit in Anspruch, da Vorschauen im Hintergrund generiert und Cover heruntergeladen werden. Wenn externe Metadaten-Websites nicht verfügbar sind, wird das automatische Scraping pausiert, obwohl die lokal gespeicherte Datenbank weiterhin offline funktioniert.

Fazit

JavBoss erwies sich als praktische, spezialisierte Lösung. Der Autor hat nicht versucht, ein weiteres klobiges Mediensystem aufzubauen, sondern ein spezifisches Problem der Katalogisierung von Nischeninhalten gelöst. Wenn Sie Ordnung auf Ihren Laufwerken benötigen, ohne zusätzliche manuelle Arbeit, ist dieses Projekt definitiv einen Versuch wert.