ralf/ntfy-downloader
Watch
1
0
Fork
You've already forked ntfy-downloader
 0
Code Issues Pull requests Projects Releases 3 Packages 1 Wiki Activity Actions
Page: Web UI und Medienverwaltung
Pages
Architektur und Sicherheit Betrieb Updates und Backup Fehlerbehebung Home Installation und Deployment Konfiguration Medienexporte Web UI und Medienverwaltung
2 Web UI und Medienverwaltung
Ralf Warmuth edited this page 2026-07-17 01:06:21 +02:00
Table of contents

Web-UI und Medienverwaltung

Die Web-UI ist eine per HTTP Basic Auth geschützte Video-Galerie. Sie liest das Downloadverzeichnis rekursiv und erzeugt Vorschaubilder bei Bedarf mit ffmpeg.

Galerie und Filter

  • Neueste Dateien erscheinen zuerst.
  • Unterverzeichnisse werden rekursiv eingelesen.
  • Tags werden als Filter in der Galerie angeboten.
  • WEBUI_DEFAULT_TAG bestimmt die ungefilterte Startansicht.
  • Über Alle bleiben auch Videos außerhalb des Standard-Tags erreichbar.
  • GIFs besitzen eine eigene Galerie und Lightbox.

Die Tags liegen nicht neben den Videos, sondern in der SQLite-Datenbank des Volumes ntfy-metadata. Sie bleiben deshalb bei Verschieben innerhalb der Web-UI erhalten.

Video ansehen

Auf der Detailseite stehen zur Verfügung:

  • HTML5-Player mit nativen Browser-Steuerelementen
  • zehn Sekunden vor- und zurückspringen
  • Download der Originaldatei
  • aktuelles Player-Timing als Start oder Ende übernehmen
  • Zeitstempel-Link erzeugen
  • Clip, GIF oder WhatsApp-Video exportieren

MP4, WebM, M4V und viele MOV-Dateien spielen Browser direkt ab. MKV und AVI können je nach Browser und enthaltenen Codecs nur heruntergeladen werden.

Tags verwalten

Tags werden komma-separiert eingegeben, zum Beispiel:

Startseite, Favorit, Musik

Leerzeichen werden normalisiert, leere Werte ignoriert und Dubletten ohne Beachtung der Groß-/Kleinschreibung entfernt. Ein Tag darf höchstens 40 Zeichen lang sein.

WhatsApp-Exporte erhalten automatisch:

  • den Tag WhatsApp
  • alle Tags des Quellvideos

Beim Start der Web-UI werden auch bereits im WhatsApp-Ordner vorhandene MP4s mit WhatsApp nachgetaggt.

Verschieben

Ein Video kann in ein vorhandenes oder ein neu angegebenes Unterverzeichnis verschoben werden. Pfade werden serverseitig normalisiert; ein Verlassen des Downloadverzeichnisses mit .., absoluten Pfaden oder Symlinks wird verhindert.

Die Tag-Zuordnung wird beim Verschieben auf den neuen relativen Pfad übertragen.

Löschen

Dauerhaft loeschen entfernt nach einer Browser-Bestätigung:

  • die Videodatei
  • die zugehörigen Tag-Einträge
  • das aus Dateiidentität und Änderungszeit abgeleitete Thumbnail, sobald es nicht mehr verwendet beziehungsweise später bereinigt wird

Es gibt keinen Papierkorb. Vor dem Löschen wichtiger Dateien ist ein Backup oder ein Snapshot des Downloadspeichers sinnvoll.

Zeitstempel-Links

Start und optionales Ende werden als Query-Parameter an /watch angehängt. Der Browser springt beim Öffnen an die markierte Position. Solche Links benötigen weiterhin die Web-UI-Anmeldung.

Schreibzugriff

Der Web-UI-Container bindet /downloads absichtlich schreibbar ein. Nur so können Tags mit Dateipfaden synchron gehalten, Unterverzeichnisse angelegt, Dateien verschoben und Exporte gespeichert werden. Deshalb muss die Web-UI besonders sorgfältig geschützt werden.

ntfy-downloader