Windows 11/10  ·  Häufige Fehler  ·  Schritt-für-Schritt-Lösungen

gallery-dl Fehlerbehebung unter Windows — Häufige Fehler beheben

Die meisten gallery-dl-Fehler unter Windows haben einfache Lösungen. Hier beginnen: gallery-dl mit gallery-dl -U aktualisieren und Cookies prüfen. Das löst 80% der Probleme.

Immer hier beginnen:

Schritt 1 — gallery-dl aktualisieren
gallery-dl -U
Schritt 2 — ausführliche Ausgabe für vollständige Fehlerdetails
gallery-dl -v "URL"

gallery-dl-Fehlermeldungen und wie man sie behebt

"Login required" oder "Authentication required"
Ursache: Die Seite erfordert Anmeldung für diesen Inhalt.

Lösung: Bei der Seite in Chrome anmelden, Browser vollständig schließen, dann ausführen: gallery-dl --cookies-from-browser chrome "URL" Wenn Cookies weiterhin ablaufen, stattdessen eine cookies.txt-Datei exportieren und --cookies verwenden. Vollständige Cookie-Anleitung.
"gallery-dl wird nicht als Befehl erkannt"
Ursache: PowerShell kann gallery-dl.exe nicht finden, da sein Ordner nicht im PATH ist.

Lösung — Option 1: Zum Ordner mit gallery-dl.exe in Explorer navigieren, Adressleiste anklicken, powershell eingeben, Enter drücken. gallery-dl von dort ausführen.

Lösung — Option 2: gallery-dl-Ordner zum PATH hinzufügen. Vollständige Anweisungen in der Installationsanleitung.
HTTP-Fehler 403 Forbidden
Ursache: Die Seite blockiert die Anfrage — entweder Rate-Limiting, Anmeldung erforderlich oder Geo-Blocking.

Lösung: gallery-dl aktualisieren: gallery-dl -U. Dann mit Cookies versuchen: gallery-dl --cookies-from-browser chrome "URL" Bei VPN-Nutzung: ohne VPN versuchen. --sleep-request 3 hinzufügen bei Rate-Limits.
gallery-dl lädt nichts herunter — beendet sich sofort
Ursache: Anmeldung erforderlich, nicht unterstütztes URL-Format oder Extraktor benötigt Update.

Lösung: Mit ausführlicher Ausgabe ausführen: gallery-dl -v "URL" Dann mit Cookies versuchen: gallery-dl --cookies-from-browser chrome "URL". gallery-dl aktualisieren: gallery-dl -U.
SSL-Zertifikatfehler unter Windows
Ursache: Windows-Zertifikatspeicher ist veraltet oder ein Proxy/VPN fängt HTTPS ab.

Lösung: Windows aktualisieren (Einstellungen → Windows Update), dann erneut versuchen. Als letztes Mittel nur: gallery-dl --no-check-certificate "URL" — langfristig nicht empfohlen.
Windows SmartScreen blockiert gallery-dl.exe
Ursache: SmartScreen kennzeichnet nicht signierte portable ausführbare Dateien — dies ist ein Fehlalarm.

Lösung: Auf Weitere InformationenTrotzdem ausführen klicken. Oder Rechtsklick auf gallery-dl.exe → Eigenschaften → Zulassen unten ankreuzen → OK.
"database is locked" bei --cookies-from-browser
Ursache: Chrome oder Edge sperrt SQLite-Cookie-Datenbank während der Ausführung.

Lösung: Browser vollständig schließen — auch Infobereich-Symbol prüfen. Dann gallery-dl erneut ausführen. Alternativ Cookies in cookies.txt exportieren und --cookies verwenden.
gallery-dl ist sehr langsam oder Downloads brechen ab
Ursache: Rate-Limiting der Seite, instabile Verbindung oder VPN-Drosselung.

Lösung: --sleep-request 3 --retries 5 zum Befehl hinzufügen. Für anhaltende Unterbrechungen --part verwenden um teilweise Downloads fortzusetzen.

Debug-Befehle — mehr Informationen erhalten

Ausführliche Ausgabe — vollständige Fehlerdetails und Anfragenprotokoll
gallery-dl -v "URL"
Simulation — auflisten was heruntergeladen würde ohne zu laden
gallery-dl --simulate "URL"
Alle verfügbaren Metadaten-Felder für eine URL ausgeben
gallery-dl --dump-json "URL"
Installierte Version prüfen
gallery-dl --version