Mini Video Library – Handbuch

Mini Video Library ist eine vollständig lokale Medienbibliothek mit Weboberfläche. Sie scannt frei wählbare Videoordner mit ffprobe, erzeugt Vorschaubilder mit ffmpeg, verwaltet Metadaten in SQLite und liefert kompatible Videodateien per HTTP Range direkt an den Browser aus.

Downloads

| Plattform | Architektur | Paket | | --- | --- | --- | | Android | ARM64 | ZIP | | macOS | AMD64 | ZIP | | macOS | ARM64 | ZIP | | FreeBSD | AMD64 | ZIP | | FreeBSD | ARM64 | ZIP | | Linux | 386 | ZIP | | Linux | AMD64 | ZIP | | Linux | ARM | ZIP | | Linux | ARM64 | ZIP | | Linux | LOONG64 | ZIP | | Linux | PPC64LE | ZIP | | Linux | RISCV64 | ZIP | | Linux | S390X | ZIP | | OpenBSD | AMD64 | ZIP | | OpenBSD | ARM64 | ZIP | | Windows | 386 | ZIP | | Windows | AMD64 | ZIP | | Windows | ARM64 | ZIP |

Die Prüfsummen aller Pakete stehen in SHA256SUMS.txt. Nach dem Entpacken liegt die Programmdatei zusammen mit README, Lizenz, Theme-Paketen und Theme-Dokumentation im Zielordner. Auf Unix-Systemen muss sie gegebenenfalls ausführbar gemacht werden:

chmod +x video-library

Voraussetzungen

Für den Betrieb werden ffmpeg und ffprobe benötigt. Beide Programme können über den PATH oder mit absoluten Pfaden in der Konfiguration angegeben werden. Unter Windows kann die Anwendung den empfohlenen Essentials-Build in den Einstellungen automatisch in ./ffmpeg installieren.

Der Browser muss die verwendeten Video- und Audiocodecs direkt unterstützen. Die Anwendung transcodiert und remuxt derzeit nicht.

Schnellstart

./video-library

Unter Windows:

.\video-library.exe

Anschließend ist die Oberfläche standardmäßig unter http://localhost:8080 erreichbar. Unter /settings wird mindestens ein absoluter Bibliotheksordner eingetragen und danach der erste Scan gestartet. Beim ersten Start entsteht eine lokale config.toml.

Ein einmaliger Scan ohne Webserver ist ebenfalls möglich:

./video-library -scan

Mit -config /pfad/config.toml lässt sich eine andere Konfigurationsdatei wählen.

Funktionen

parallele Scans mit Fortschritt, ETA, Abbruch und vollständigem Neuaufbau
Schutz vor Datenverlust bei vorübergehend nicht erreichbaren Laufwerken
Suche, Filter, Favoriten, Wiedergabefortschritt und Seitennavigation
Smart Collections für neue, ungesehene, angefangene und favorisierte Videos, erkannte Episoden, 4K-Inhalte und fehlende Cover
Erkennung von Serienfolgen aus Dateinamen
bearbeitbare Titel, Beschreibungen und Tags
Poster, mehrere Vorschaubilder und erneute Thumbnail-Erzeugung
Übersicht über Audio- und Untertitelspuren sowie externe SRT-/VTT-Untertitel
Medienprüfung, Problemdateien, Statistiken und Hash-basierte Duplikaterkennung
deutsche und englische Oberfläche, sechs mitgelieferte Themes und Theme-Import
Live-Logs und rotierende Logdateien
TMDB-/AniDB-Metadaten, NFO-Import und -Export sowie lokaler Metadaten-Editor

Daten und Datenschutz

Konfiguration, SQLite-Datenbank, Vorschaubilder, Poster, Logs und Plugin-Zugangsdaten bleiben lokal. Standardmäßig liegen sie unter config.toml und data/. Diese Laufzeitdaten sind nicht Teil der öffentlichen Downloads und nicht im öffentlichen Git-Mirror enthalten.

NFO-Dateien werden nur nach ausdrücklicher Aktion neben dem jeweiligen Video gelesen oder geschrieben. Online-Metadaten werden lokal zwischengespeichert.

Themes

Ein Theme ist ein ZIP-Archiv mit theme.json und theme.css im Wurzelverzeichnis. Es darf CSS, Bilder und Webfonts enthalten, jedoch kein JavaScript, keine ausführbaren Dateien, keine externen URLs und keine CSS-Imports. Details stehen in docs/themes.md im Git-Mirror.

Aus dem öffentlichen Quellcode bauen

Der öffentliche Mirror enthält bewusst keine internen Testdateien und keine persönlichen Konfigurationen oder Laufzeitdaten.

git clone https://zanvex.de/git/mini-video-library.git
cd mini-video-library
go build ./cmd/video-library

Voraussetzung ist Go 1.26 oder neuer. Unter PowerShell erzeugt das Release-Skript plattformspezifische ZIP-Pakete:

.\scripts\build.ps1 -Targets windows/amd64,linux/amd64,darwin/arm64

Lizenz

Mini Video Library steht unter der MIT-Lizenz. Der vollständige Lizenztext liegt als LICENSE im Git-Mirror.