Media Viewer #

Der Media Viewer zeigt Bilder und Videos im Browser an, als Vollbild mit Blättern, Drehen, Zoomen und Video-Steuerung. Er arbeitet in der Dateiliste und in öffentlichen Links auf Ordner. Bilder kommen aus der Vorschau des Servers, Videos spielt der Browser direkt aus dem Speicher ab.

Voraussetzungen #

Installation #

Im App-Menü Markt öffnen, Media Viewer suchen und Installieren wählen. Auf der Kommandozeile:

# App aus dem Marktplatz installieren, dabei wird sie eingeschaltet
sudo -u www-data php8.4 occ market:install files_mediaviewer

# nur nötig, wenn die App schon vorhanden, aber ausgeschaltet ist
sudo -u www-data php8.4 occ app:enable files_mediaviewer

Einrichtung #

Die App hat keine Einstellungsseite und keine eigenen Schlüssel. Was sie anzeigen kann, steuern die Vorschau-Einstellungen in config/config.php:

Ohne eigenen Eintrag sind diese Anbieter aktiv: OC\Preview\MarkDown, OC\Preview\MP3, OC\Preview\TXT, OC\Preview\PNG, OC\Preview\JPEG, OC\Preview\WEBP, OC\Preview\GIF, OC\Preview\BMP, OC\Preview\Heic, OC\Preview\XBitmap und OC\Preview\SGI.

Setzen Sie enabledPreviewProviders selbst, ersetzt Ihre Liste die Vorgabe vollständig. Nehmen Sie deshalb auch die Anbieter auf, die Sie behalten wollen. Dieses Beispiel behält alle Anbieter der Vorgabe und ergänzt SVG und TIFF:

'enable_previews' => true,
'enabledPreviewProviders' => [
    'OC\\Preview\\MarkDown',
    'OC\\Preview\\MP3',
    'OC\\Preview\\TXT',
    'OC\\Preview\\PNG',
    'OC\\Preview\\JPEG',
    'OC\\Preview\\WEBP',
    'OC\\Preview\\GIF',
    'OC\\Preview\\BMP',
    'OC\\Preview\\Heic',
    'OC\\Preview\\XBitmap',
    'OC\\Preview\\SGI',
    'OC\\Preview\\SVG',
    'OC\\Preview\\TIFF',
],

Vorschaubilder von Videos in der Dateiliste brauchen zusätzlich den Anbieter OC\Preview\Movie und ffmpeg oder avconv auf dem Server. Auf die Wiedergabe im Viewer hat das keinen Einfluss.

Die Liste der anzeigbaren Typen bekommt der Browser beim Laden der Seite. Nach einer Änderung laden Sie die Dateiansicht neu.

Unterstützte Formate #

Ein Video bekommt nur dann die Aktion des Viewers, wenn der Browser den Typ abspielen kann. Sonst lädt ein Klick die Datei herunter.

Nutzung #

Ein Klick auf ein Bild oder Video öffnet den Viewer. Im Menü … der Datei heißt der Eintrag Mit Media Viewer öffnen. Der Viewer zeigt alle passenden Dateien des Ordners nacheinander:

• Blättern über die Pfeile, per Wischgeste oder mit den Pfeiltasten. Esc schließt den Viewer.
• Bilder: drehen in Schritten von 90 Grad, vergrößern, verkleinern, herunterladen.
• Videos: abspielen, von vorn beginnen, Ton aus, Vollbild, Sprung über die Fortschrittsleiste.

Der Media Viewer zeigt die Bilder eines Ordners nacheinander. Sie öffnen ihn über „…“ und „Mit Media Viewer öffnen“.

Grenzen und Hinweise #

• Zusammen mit der Galerie: Media Viewer und Galerie tragen sich beide als Standardaktion für Bilder ein. Sind beide eingeschaltet, öffnet ein Klick auf ein Bild in der Regel die Diashow der Galerie, weil diese ihre Aktion später einträgt. Den Media Viewer erreichen Sie dann über … und Mit Media Viewer öffnen. Videos öffnet weiter der Media Viewer.
• Bilder lädt der Viewer nicht im Original, sondern als Vorschau. Er fordert je nach Fensterbreite 1024 bis 3840 Pixel an, preview_max_x und preview_max_y begrenzen auf 2048. Für schärfere Bilder auf großen Bildschirmen erhöhen Sie beide Werte.
• Bilder über 50 MB (preview_max_filesize_image) bekommen keine Vorschau und bleiben deshalb im Viewer leer.
• Videos werden nicht umgewandelt. Spielt der Browser einen Codec nicht ab, hilft nur eine Umwandlung nach MP4 (H.264/AAC).

Fehlersuche #