Willkommen im Wiki.

ntfy-downloader

ntfy-downloader verbindet ein geschütztes ntfy-Topic mit yt-dlp und einer kleinen Web-Galerie. Eine Nachricht mit einer HTTP(S)-URL erzeugt einen persistent gespeicherten Downloadauftrag. Fortschritt und Ergebnis werden auf dasselbe Topic zurückgemeldet; heruntergeladene Videos lassen sich danach im Browser verwalten, taggen und weiterverarbeiten.

Schnellüberblick

ntfy-Nachricht -> Listener -> SQLite-Jobqueue -> yt-dlp -> Downloadverzeichnis
                       |                         |
                       +---- Status an ntfy <---+

Browser -> Web-UI -> Galerie, Tags, Verschieben, Löschen, Clips, GIF, MP4

Der Docker-Stack besteht aus zwei Diensten:

Dienst	Aufgabe
ntfy-downloader	Lauscht auf ntfy, verwaltet die Jobqueue und startet yt-dlp
ntfy-webui	Stellt Galerie, Player und Medienexporte auf Port 2310 bereit

Beide Dienste verwenden dasselbe Downloadverzeichnis. Jobqueue, Thumbnails und Video-Tags werden getrennt persistent gespeichert.

Dokumentation

• Installation und Deployment
• Konfiguration
• Web-UI und Medienverwaltung
• Clips, GIFs und WhatsApp-Videos
• Betrieb, Updates und Backup
• Architektur und Sicherheit
• Fehlerbehebung

Typischer Ablauf

1. Eine Nachricht mit einer Video-URL an das konfigurierte ntfy-Topic senden.
2. Auf die Start- und Abschlussmeldung im Topic warten.
3. Das Video in der Web-UI öffnen.
4. Tags vergeben, die Datei verschieben oder einen Zeitbereich markieren.
5. Den Bereich wahlweise als Clip, GIF oder WhatsApp-kompatibles MP4 exportieren.

Wichtige Betriebsgrundsätze

• Produktiv immer einen vollständigen Commit-SHA als Image-Tag verwenden.
• DOWNLOAD_DIR muss vor dem Start vorhanden und für die konfigurierte UID/GID les- und schreibbar sein.
• ntfy-state und ntfy-thumbs sind im Registry-Compose-Setup externe Volumes.
• Zugangsdaten gehören ausschließlich in die lokale .env, nie ins Git.
• Web-UI und ntfy außerhalb eines vertrauenswürdigen Netzes nur per HTTPS bereitstellen.