gallery-dl für Twitter / X verwenden
Diese Anleitung zeigt, wie Sie X-Profile und Beiträge testen, lokale Browser-Cookies verwenden, Medien ordentlich speichern, Duplikate verhindern und Authentifizierungs- oder Rate-Limit-Fehler beheben.
Beginnen Sie mit einer x.com-URL in Anführungszeichen und --simulate. Fordert der Extraktor eine Anmeldung, verwenden Sie --cookies-from-browser mit einem eigenen Browserprofil. Ergänzen Sie nach einem kleinen erfolgreichen Test ein dauerhaftes Download-Archiv.
Twitter-URL vor dem Download testen
gallery-dl erkennt verschiedene Twitter-/X-URL-Typen: einzelne Beiträge, die /media-Seite eines Kontos, Timelines, Likes, Lesezeichen, Listen, Suchen und weitere unterstützte Extraktorseiten. Für den ersten Versuch eignen sich ein öffentlicher Status oder die Medienseite eines Profils. Kopieren Sie die kanonische x.com-URL, setzen Sie sie in Anführungszeichen und simulieren Sie die Extraktion, bevor Dateien geschrieben werden.
Die Simulation zeigt, ob Ihre Version aktuell genug ist, ob die URL den richtigen Extraktor auslöst, ob eine Anmeldung nötig ist und welche Dateien ausgewählt würden. Eine Timeline kann Reposts, Antworten, Zitate, Videos und wiederholte Medien mischen. Eine erkannte URL bedeutet daher noch nicht, dass der Standardumfang zu Ihrer Aufgabe passt.
gallery-dl --simulate "https://x.com/BENUTZER/status/BEITRAGS_ID"gallery-dl --simulate "https://x.com/BENUTZER/media"gallery-dl -K "https://x.com/BENUTZER/status/BEITRAGS_ID"BENUTZER und BEITRAGS_ID müssen durch eine echte URL ersetzt werden, auf die Sie zugreifen dürfen.
Wiederholbaren Twitter-Download einrichten
Nach einer erfolgreichen Simulation wählen Sie einen eindeutigen Zielordner und ergänzen ein Download-Archiv. Es speichert die IDs erfolgreich geladener Dateien und überspringt sie bei späteren Läufen, selbst wenn sich Dateinamen ändern. Begrenzen Sie den ersten echten Download, prüfen Sie Pfade und Medientypen und erweitern Sie die Aufgabe erst danach.
Der Twitter-Extraktor kann Antworten, Reposts, zitierte Beiträge, Karten, Artikel, Vorschauen, reine Textbeiträge und Videos ein- oder ausschließen. Standardwerte können sich ändern. Prüfen Sie Felder mit -K, bevor Sie Dateinamen oder Filter bauen, verwenden Sie für die wiederkehrende Aufgabe dasselbe Archiv und veröffentlichen Sie keine geheimen Profil- oder Sitzungspfade.
gallery-dl --cookies-from-browser firefox --range "1-25" --download-archive "twitter.sqlite3" "https://x.com/BENUTZER/media"gallery-dl --destination "D:/Media/X" --download-archive "twitter.sqlite3" "https://x.com/BENUTZER/media"gallery-dl --write-metadata --download-archive "twitter.sqlite3" "https://x.com/BENUTZER/media"| Ziel | Option | Nutzen |
|---|---|---|
| Ohne Dateien testen | --simulate | Prüft Extraktor, Zugriff und Auswahl |
| Erstes Paket begrenzen | --range 1-25 | Erleichtert die Kontrolle |
| Duplikate verhindern | --download-archive DATEI | Merkt erfolgreiche IDs |
| Lokale Anmeldung nutzen | --cookies-from-browser BROWSER | Liest ein eigenes Profil |
| Felder prüfen | -K URL | Zeigt Daten für Namen und Filter |
gallery-dl für Twitter / X konfigurieren
Übernehmen Sie Optionen erst dann in die Konfiguration, wenn die sichtbare Befehlszeile funktioniert. Die offizielle Beispieldatei enthält Twitter-Werte wie include, replies, retweets, quoted, videos, Größenwahl, API-Wiederholungen und Rate-Limit-Verhalten. Ein kleiner geprüfter Block ist wartbarer als eine vollständige Kopie, deren Auswirkungen unklar sind.
Das Beispiel behält Videos, schließt Antworten, Reposts und Zitate aus, wartet bei einem Limit und verwendet ein stabiles Archiv. Die Browserauswahl kann in der Befehlszeile bleiben, wenn verschiedene Rechner unterschiedliche Profile nutzen. Prüfen Sie gültiges JSON: Kommentare, abschließende Kommas und nicht maskierte Windows-Backslashes führen zu Fehlern.
{
"extractor": {
"twitter": {
"replies": false,
"retweets": false,
"quoted": false,
"videos": true,
"ratelimit": "wait",
"archive": "D:/gallery-dl/twitter.sqlite3"
}
}
}gallery-dl --config-ignore --simulate "https://x.com/BENUTZER/media"gallery-dl --config-statusgallery-dl-Twitter-Fehler beheben
Unterscheiden Sie Anmeldung, Rate Limit, leere Ergebnisse und Duplikate. AuthRequired weist meist auf fehlende oder abgelaufene Cookies hin. HTTP 429 bedeutet, dass der Extraktor warten sollte, statt aggressiv neu zu versuchen. Leere Ergebnisse können von einem falschen URL-Typ, unzugänglichen Inhalten, strengen Filtern oder bereits archivierten IDs stammen.
Vergleichen Sie eine saubere Simulation mit --config-ignore mit derselben URL unter Ihren normalen Einstellungen. Fügen Sie Cookies, Bereich, Archiv und Filter einzeln hinzu. Aktualisieren Sie gallery-dl über denselben Installationskanal, prüfen Sie die Version und lesen Sie aktuelle Upstream-Meldungen, bevor Sie bei einer X-Änderung wiederholt neue Anfragen starten.
| Symptom | Erste Prüfung | Sicherer Schritt |
|---|---|---|
| Cookies erforderlich | Ziel im gewählten Profil öffnen | Normale Anmeldung erneuern und simulieren |
| HTTP 429 | ratelimit und Wiederholungen prüfen | Warten, keine parallelen Schleifen |
| Keine Dateien | --config-ignore ohne Filter | URL, Zugriff und Extraktor prüfen |
| Alles übersprungen | Archivpfad prüfen | Temporäres Archiv nur zur Diagnose |
| Unerwartete Antworten | Twitter-Werte prüfen | replies, retweets und quoted festlegen |
Grenzen vor großen Downloads kennen
gallery-dl ist ein lokaler Downloader und kein Berechtigungssystem. Laden Sie nur Medien, auf die Sie rechtmäßig zugreifen und die Sie verwenden dürfen. Beachten Sie Privatsphäre, Urheberrecht, geltende Plattformregeln und Gesetze. Teilen Sie niemals Cookies, Tokens, private Archive oder heruntergeladene persönliche Daten.
Am 30. Juli 2026 verifizierte diese Website gallery-dl 1.32.8 über offizielle PyPI-Metadaten und bestätigte HTTP 200 sowie erwartete Namen und Größen für die offiziellen Windows- und Linux-Dateien auf Codeberg. X kann sein Verhalten ändern; prüfen Sie bei neuen Fehlern erneut Release, Dokumentation und Extraktorstatus.
FAQ zu gallery-dl und Twitter / X
Funktioniert gallery-dl mit Twitter / X?
Ja. Der Extraktor erkennt Beiträge, Medienseiten, Timelines, Likes, Lesezeichen, Listen, Suchen und weitere unterstützte URLs. Testen Sie die konkrete URL.
Warum sind authentifizierte Cookies nötig?
X begrenzt anonymen Zugriff. Melden Sie sich normal im eigenen Profil an und verwenden Sie dieses mit --cookies-from-browser.
Wie lade ich nur Medien eines Kontos?
Beginnen Sie mit der /media-URL, simulieren Sie und laden Sie zuerst einen kleinen Bereich.
Wie vermeide ich Duplikate?
Verwenden Sie einen stabilen Pfad mit --download-archive; gallery-dl speichert erfolgreiche IDs.
Was tun bei einem Rate Limit?
Lassen Sie ratelimit warten, reduzieren Sie Anfragen und vermeiden Sie parallele Wiederholungen. Eventuell ist ein Update nötig.
Kann ich meine Konfiguration teilen?
Nur nach Entfernung von Cookie-Pfaden, Profilnamen, Konten, privaten Archiven, URLs und Tokens.