CLI
Outil en ligne de commande pour télécharger des vidéos X (Twitter), et flux d'authentification utilisé par le serveur MCP.
Installation
Nécessite Node.js >= 24. Aucune installation globale requise — lancez-le directement avec npx, ou installez-le globalement :
npm install -g @roudanio/x-downloader-cliyt-dlp dans votre PATH pour les téléchargements directs, ainsi que ffmpeg sauf si vous passez -f best. Aucun des deux n'est nécessaire pour le serveur MCP ou les commandes auth.
Démarrage rapide
Les téléchargements directs utilisent votre yt-dlp local — aucun compte requis :
x-downloader https://x.com/user/status/123456789Options de téléchargement
| -o, --output <dir> | Dossier de sortie (par défaut ~/Downloads) |
| -n, --filename <name> | Nom de fichier de sortie personnalisé |
| -f, --format <format> | Sélecteur de format yt-dlp (par défaut bestvideo*+bestaudio/best) |
| -F, --list-formats | Lister les formats disponibles puis quitter |
| --cookies <file> | Fichier de cookies à transmettre à yt-dlp |
| --proxy <url> | URL de proxy à transmettre à yt-dlp |
| --dry-run | Afficher la commande yt-dlp résolue au lieu de l'exécuter |
Authentification
auth login / auth logout / auth status gèrent un jeton d'autorisation par appareil que le serveur MCP (x-downloader-mcp) utilise pour appeler l'API du site. La commande de téléchargement direct ci-dessus n'utilise jamais ce jeton et n'appelle jamais le site.
Codes de sortie
| 0 | Succès |
| 1 | Erreur générique (arguments invalides, échec d'authentification, yt-dlp terminé avec une erreur) |
| 2 | Dépendance manquante (yt-dlp introuvable, ou ffmpeg absent pour le format par défaut) |
| other | Transmis tel quel depuis le processus yt-dlp sous-jacent |
Sortie lisible par machine
Pas encore disponible pour les téléchargements directs — la sortie est en texte brut. Utilisez le serveur MCP ou directement l'API REST si vous avez besoin de réponses structurées.