CLI

Kommandozeilen-Tool zum Herunterladen von X-(Twitter-)Videos und der Authentifizierungsablauf, den der MCP-Server nutzt.

Installation

Erfordert Node.js >= 24. Keine globale Installation nötig – direkt mit npx ausführen oder global installieren:

npm install -g @roudanio/x-downloader-cli

yt-dlp im PATH für direkte Downloads, außerdem ffmpeg, sofern Sie nicht -f best angeben. Für den MCP-Server oder die auth-Befehle wird keines von beiden benötigt.

Schnellstart

Direkte Downloads nutzen Ihr lokales yt-dlp – kein Konto nötig:

x-downloader https://x.com/user/status/123456789

Download-Optionen

-o, --output <dir>	Ausgabeverzeichnis (Standard ~/Downloads)
-n, --filename <name>	Eigener Dateiname für die Ausgabe
-f, --format <format>	yt-dlp-Formatauswahl (Standard bestvideo*+bestaudio/best)
-F, --list-formats	Verfügbare Formate auflisten und beenden
--cookies <file>	Cookie-Datei, die an yt-dlp übergeben wird
--proxy <url>	Proxy-URL, die an yt-dlp übergeben wird
--dry-run	Den aufgelösten yt-dlp-Befehl ausgeben, statt ihn auszuführen

Authentifizierung

auth login / auth logout / auth status verwalten ein Geräte-Token, mit dem der MCP-Server (x-downloader-mcp) die API der Website aufruft. Der direkte Download-Befehl oben nutzt dieses Token nie und ruft die Website nie auf.

Exit-Codes

0	Erfolg
1	Allgemeiner Fehler (ungültige Argumente, Authentifizierung fehlgeschlagen, yt-dlp mit Fehler beendet)
2	Fehlende Abhängigkeit (yt-dlp nicht gefunden oder ffmpeg fehlt für das Standardformat)
other	Unverändert vom zugrunde liegenden yt-dlp-Prozess durchgereicht

Maschinenlesbare Ausgabe

Für direkte Downloads noch nicht verfügbar – die Ausgabe ist Klartext. Nutzen Sie den MCP-Server oder direkt die REST API, wenn Sie strukturierte Antworten brauchen.