Download Video

⚠️ Ne pas lancer directement un downloader générique sans avoir d'abord identifié la plateforme. Le bon downloader / fallback dépend de la source.

Pour Twitter/X URLs

Si l'URL est un tweet X/Twitter (x.com ou twitter.com) :

1. Extraire le tweet ID depuis l'URL
2. Utiliser clix pour récupérer l'URL média directe :

source ~/clix-env/bin/activate
clix tweet <tweet_id> --json | python3 -c "
import sys, json
data = json.load(sys.stdin)
# Le tweet principal ou le premier dans le thread
tweet = data[0] if isinstance(data, list) else data
for m in tweet.get('media', []):
    if m['type'] == 'video':
        print(m['url'])
    elif m['type'] == 'photo':
        print(m['url'])
"

3. Télécharger la vidéo :

export PATH="$HOME/.local/bin:$PATH"
cd /home/openclaw/.openclaw/workspace
# Essai 1 : yt-dlp avec l'URL du tweet
yt-dlp -o "video_download.%(ext)s" "<TWEET_URL>"
# Si échec ou résultat vide : fallback clix -> URL média directe -> curl
curl -L -o video_download.mp4 "<MEDIA_URL>"

4. Si yt-dlp échoue sur X/Twitter, considérer ça comme normal et basculer immédiatement sur le fallback clix puis curl. Ne pas insister inutilement avec le mauvais downloader.
5. Continuer avec les étapes Check size / Compress / Send ci-dessous

Pour toutes les autres plateformes

Après identification de la source, utiliser le flow approprié. Si aucune logique spécifique n'existe pour la plateforme, utiliser le flow générique yt-dlp.

1. Download

export PATH="$HOME/.local/bin:$PATH"
cd /home/openclaw/.openclaw/workspace
# TOUJOURS utiliser -f b (pre-merged) pour éviter les freezes vidéo
yt-dlp -f b -o "video_download.%(ext)s" "<URL>"

⚠️ IMPORTANT :

• Toujours utiliser -f b (best pre-merged format) au lieu du défaut DASH split. Le merge DASH crée souvent des freezes vidéo.
• Si le codec est VP9 (vp09) et que Mathis veut publier sur Twitter/X, reconvertir en H.264 :

ffmpeg -y -i video.mp4 -c:v libx264 -crf 18 -c:a aac -b:a 192k video_h264.mp4

• Toujours vérifier le codec avec ffprobe avant d'envoyer.
• Ne jamais compresser pour réduire la taille — si >16MB, upload sur Google Drive en qualité originale.

For Instagram:

• ⚠️ Sans auth, yt-dlp peut télécharger la vidéo SANS AUDIO — toujours vérifier avec ffprobe que le fichier a bien 2 streams (video + audio)
• Si pas d'audio → il faut des cookies Instagram ou un autre outil
• Pour private content, cookies obligatoires

2. Check size

ls -lh video_download.*

3. Compress if needed (Telegram bot limit = 16MB)

ffmpeg -y -i video_download.mp4 \
  -vcodec libx264 -crf 28 -preset fast \
  -acodec aac -b:a 128k \
  video_compressed.mp4

Adjust -crf if still too large:

• 28 = good quality, ~25-30% size reduction
• 32 = acceptable quality, ~50% reduction
• 35 = lower quality, ~65% reduction

4. Send

Si <16MB → envoyer via Telegram :

message(action=send, target=<chat_id>, filePath=<path>, caption="...")

File must be under /home/openclaw/.openclaw/workspace/ for Telegram send.

Si >16MB → NE PAS compresser. Upload directement sur Google Drive en qualité originale et envoyer le lien. Mathis veut la qualité intacte, pas de perte.

5. Cleanup

rm -f video_download.* video_compressed.*

Troubleshooting

• Twitter 403/rate limit : Les cookies clix peuvent expirer, voir skill twitter-cli pour re-auth
• yt-dlp échoue sur Twitter : Utiliser la méthode clix (extraire URL média directe puis curl)
• Instagram 401/login required : Need to pass cookies via --cookies-from-browser chrome
• Still too large after compression : Try -crf 35 or scale down: -vf scale=-2:720
• yt-dlp outdated : pip install --upgrade yt-dlp
• ffmpeg not found : export PATH="$HOME/.local/bin:$PATH" or reinstall static binary from johnvansickle.com