Videogalerie — den Nextcloud-Videoplayer installieren

Installation

Installiere ffmpeg auf dem Server: sudo apt install ffmpeg (Debian, Ubuntu), sudo dnf install ffmpeg (Fedora, RHEL) oder sudo apk add ffmpeg (Alpine).
Melde dich in deinem MediaLab-Works-Konto an, öffne Lizenzen und lade das App-Archiv videogallery-x.y.z.tar.gz herunter (verfügbar bei einem aktiven Abonnement, einer Lifetime-Lizenz innerhalb ihres Update-Zeitraums oder während des kostenlosen 30-tägigen Testzeitraums).
Entpacke es in den Nextcloud-Ordner apps/ (oder custom_apps/), sodass du apps/videogallery/ erhältst, im Besitz des Webserver-Benutzers:
```
cd /var/www/nextcloud/apps
sudo tar -xzf ~/videogallery-x.y.z.tar.gz
sudo chown -R www-data:www-data videogallery
```
Aktiviere es: sudo -u www-data php occ app:enable videogallery oder über die Seite Apps.
Öffne Verwaltungseinstellungen → Video Gallery → License, füge deinen Lizenzschlüssel ein und speichere. Die App kontaktiert den Lizenzserver, bindet den Schlüssel an diese Nextcloud-Instanz und zeigt die Lizenz als Active an.
Erstelle die Bibliothek auf einen Schlag, statt auf den Hintergrund-Job zu warten: sudo -u www-data php occ videogallery:scan.

Lizenz

Die Lizenz wird einmal täglich geprüft. Ohne Internet arbeitet die App 7 Tage nach der letzten erfolgreichen Prüfung weiter; danach wird sie gestoppt, bis sie wieder prüfen kann.

Ohne gültige Lizenz wird die App gestoppt: Indexierungs-, Vorschau- und Bereinigungs-Jobs laufen nicht, Bibliothek, Player und API antworten mit dem Grund, und nur der Abschnitt License funktioniert weiter (dort kannst du den Test starten, den Schlüssel eingeben oder verlängern). Nichts wird gelöscht: Deine Videos werden nie angetastet, und Bibliothek, Wiedergabepositionen und Einstellungen bleiben für die Zeit erhalten, bis die Lizenz wieder gültig ist.

Konfiguration

Öffne Verwaltungseinstellungen → Video Gallery. Die App findet ffmpeg, testet, was dieser Rechner wirklich kann, und wählt selbst ein Scratch-Verzeichnis; die Seite sagt in einem Satz, was fehlt, und gibt den Befehl an, der es behebt.

This server: die Encoder, die hier funktionieren (NVENC, Quick Sync, VA-API, VideoToolbox oder Software). Test the hardware again, nachdem du Treiber geändert hast.
Measure this machine: testet die Grafikkarte mit einem anspruchsvollen Beispiel und behält die beste funktionierende Kombination aus Presets und Decode-Pfad. Jeder Wert kann überschrieben werden.
Graphics cards: bei mehreren Karten schalte jede einzeln ein oder aus oder gib ihr ihr eigenes Limit.
Working files: das Scratch-Verzeichnis für Konvertierungen. Lege es auf eine schnelle Platte, nicht die Systemplatte; die App löscht nur innerhalb ihres eigenen markierten Verzeichnisses.
Conversion: konvertiere Formate, die der Browser nicht öffnen kann; dekodiere auf der Grafikkarte und encodiere ebenfalls darauf; Anzahl gleichzeitiger Konvertierungen; Segmentlänge.
Quality and the connection: die Verbindung vor der Wiedergabe messen und währenddessen weiter anpassen.
Previews: Länge und Höhe des Clips beim Darüberfahren, Platz für zwischengespeicherte Vorschauen.
Kinds of folder: die Regeln, die Ordner in Kurse, Kamera, Serien und Filme einteilen.
The library: der Ordner, der in jedem Konto für Videos angelegt wird; Dateien, die unter einer bestimmten Länge übersprungen werden; ffmpeg-Pfad, falls es an einem ungewöhnlichen Ort liegt; VA-API-Gerät.

PHP-FMM die Grafikkarte benutzen lassen. — careful: PHP-FPM.

PHP-FPM die Grafikkarte benutzen lassen. Viele Distributionen starten PHP-FPM mit PrivateDevices=true, das die Karte versteckt („no CUDA-capable device is detected“, obwohl sie von einer Shell aus funktioniert). Für NVIDIA füge mit sudo systemctl edit php8.4-fpm (deine PHP-Version) eine Drop-in-Datei hinzu:

[Service]
PrivateDevices=no
DevicePolicy=closed
DeviceAllow=/dev/nvidia0 rw
DeviceAllow=/dev/nvidiactl rw
DeviceAllow=/dev/nvidia-uvm rw
DeviceAllow=/dev/nvidia-uvm-tools rw
DeviceAllow=/dev/nvidia-modeset rw

Für Intel und AMD: sudo usermod -aG render www-data. Dann sudo systemctl daemon-reload && sudo systemctl restart php8.4-fpm.

Tägliche Nutzung

Öffne Video Gallery aus dem oberen Menü. Stöbere in der Timeline, in Ordnern oder suche; ändere die Order in der oberen Leiste.
Drücke auf Play: Die App wählt, wie die Datei gesendet wird, und zeigt es im Qualitätsmenü an (Automatic (4.0 Mbit/s)). Wähle dort eine feste Qualität, wenn du das lieber möchtest.
Untertitel und Tonspuren findest du in den Player-Menüs; Dateien wie Film.en.srt oder Film_en.srt neben dem Video werden ebenfalls gefunden.
Open in another player übergibt das Original an VLC oder Infuse — für einen Fernseher oder eine bitgenaue Kopie.
Teile ein Video oder einen Ordner aus dessen Menü; entscheide, ob es heruntergeladen werden darf.
Befehle: occ videogallery:scan [user], occ videogallery:preview [user], occ videogallery:status [--probe], occ videogallery:cleanup [--all].

Fehlersuche

Etwas spielt nicht ab: Führe sudo -u www-data php occ videogallery:selftest aus. Er konvertiert einen Teil einer echten Datei in beide Richtungen, springt in die Mitte, prüft, ob das Ergebnis abspielt, und dass nichts zurückbleibt.
Die Grafikkarte wird nicht benutzt: Prüfe occ videogallery:status. Meist kann PHP-FPM die Karte nicht sehen (PrivateDevices) oder www-data ist nicht in der Gruppe render; siehe Konfiguration.
ffmpeg nicht gefunden: Installiere es oder setze seinen Pfad unter The library → Paths, if ffmpeg is somewhere unusual.
Neue Videos erscheinen nicht: Hintergrund-Jobs müssen laufen (Cron); klicke unter The library in den Einstellungen auf Look for new files oder führe occ videogallery:scan aus.