Vai al contenuto
yt-dlp

Generatore di comandi yt-dlp per X (Twitter)

Componi un comando yt-dlp per un video su X, con nomi di file prevedibili e le opzioni che i contenuti sensibili richiedono.

Facoltativo. Se lo lasci vuoto il comando finisce con URL, da riempire tu.

Il tuo comando

yt-dlp --merge-output-format mp4 --no-playlist -o '%(uploader_id)s - %(id)s.%(ext)s' https://x.com/user/status/1234567890
Base

Solo audio estrae la traccia sonora e scarta il video.

Video e qualità

Mette un tetto all'altezza. yt-dlp sceglie comunque la traccia migliore entro quel limite.

Il tipo di file in cui vengono uniti video e audio separati.

Opzioni avanzate (3)

Sostituisce il menu della qualità. Per chi conosce già la sintassi dei formati.

Reimpacchetta le tracce senza ricodificare. Veloce e senza perdite.

Ricodifica il video. Lento e con perdite — solo se remux non basta.

Audio

Il file in cui l'audio viene convertito.

Il VBR dà il miglior rapporto dimensione/qualità; un bitrate fisso è più prevedibile.

Sottotitoli

Incorporare li mette dentro il video; salvare scrive un .srt separato accanto.

Separate da virgola. Scrivi all per tutte le lingue disponibili.

Playlist e canali

Cosa fare quando l'URL appartiene sia a un video sia a una playlist.

Funzionano sia gli intervalli sia gli elenchi, per esempio 1-10,15 oppure -5::2 per uno ogni due partendo dalla fine.

Opzioni avanzate (1)

Annota cosa è già stato scaricato, così una nuova esecuzione lo salta. È così che si tiene sincronizzato un canale.

Spezzoni e capitoli
Opzioni avanzate (2)

Un intervallo come *00:01:30-00:03:00, oppure il nome di un capitolo. L'asterisco iniziale indica che è un orario.

Metadati e copertina
Opzioni avanzate (3)
SponsorBlock

Taglia dal file gli spezzoni segnalati dalla comunità, in base ai dati di SponsorBlock.

Opzioni avanzate (1)

Tiene gli spezzoni ma li segnala, così li salti tu.

File e cartelle

I nomi dei campi vanno dentro %(...)s. Le barre creano cartelle.

Opzioni avanzate (4)

Dove vengono scritti i file. Combinandola col modello sopra si ottengono sottocartelle.

Lunghezza massima del nome file, in caratteri.

Filtri
Opzioni avanzate (5)

AAAAMMGG, oppure una data relativa come now-1month.

AAAAMMGG, oppure una data relativa.

Salta tutto ciò che è più piccolo. Accetta 5M, 500K e simili.

Salta tutto ciò che è più grande.

Quanti file scaricare prima di fermarsi.

Rete

Per esempio 2M o 500K. Utile quando ti serve il resto della banda.

Opzioni avanzate (5)

Velocizza i flussi frammentati. Quattro è un punto di partenza sensato.

Quante volte riprovare una parte fallita. È ammesso anche infinite.

URL di un proxy HTTP, HTTPS o SOCKS.

Fa sembrare le richieste provenienti da un browser vero. È il rimedio classico quando compare un 403 improvviso.

Accesso e cookies

Legge direttamente la tua sessione. Serve per contenuti privati, con limite d'età o riservati agli iscritti.

Opzioni avanzate (1)

Un cookies.txt in formato Netscape esportato dal tuo browser.

Diretta
Opzioni avanzate (2)

Continua a controllare finché una diretta programmata non parte. MIN-MAX sono i secondi tra i controlli.

Aggiramenti
Opzioni avanzate (3)

Deprecato in favore di --add-headers. Resta perché tante guide vecchie lo usano ancora.

Deprecato in favore di --add-headers.

Opzioni specifiche di un sito, per esempio youtube:player_client=web.

Output e debug
Opzioni avanzate (2)
Reimposta

Da tenere presente su X

Funzionano sia gli indirizzi x.com sia twitter.com. Quello che su X chiamano GIF sono in realtà brevi video MP4, quindi si scaricano come qualsiasi altro video; converti dopo se ti serve una GIF vera.

I post con contenuti sensibili richiedono una sessione autenticata con la relativa impostazione attiva. Il modello predefinito nomina i file per autore e id del post, così una cartella piena di questi file resta consultabile.

X ha cambiato più volte la superficie della sua API, e la conseguenza pratica è che le correzioni degli estrattori arrivano negli aggiornamenti di yt-dlp entro giorni — un'installazione più vecchia di qualche settimana è dove vivono davvero la maggior parte dei rapporti "X è rotto". Aggiorna prima di fare debug: yt-dlp -U. L'accesso ospite va e viene; quando viene ritirato, una sessione autenticata con cookies è la via che funziona, ed è anche l'unica via ai media sensibili.

I thread e i post-citazione sono dove le URL diventano confuse. Un tweet con un video lo incorpora; lo stesso video nella scheda media del profilo è una voce a parte. Per un intero account, l'URL della scheda media prende tutto ciò che è stato pubblicato con media, paginato, e il file di archivio più "continua dopo gli errori" gestisce i post cancellati che un account attivo accumula inevitabilmente. I download da URL di ricerca qui non sono supportati di proposito: i risultati cambiano tra le richieste, e un archivio su una ricerca in movimento non ha significato.

X serve il video come fragment HLS con un ripiego MP4 nella maggior parte dei casi, quindi le unioni sono frequenti e ffmpeg è la dipendenza da controllare per prima. I post "GIF" sono l'eccezione da conoscere: arrivano come MP4 come tutto il resto, e convertirli dopo in un vero GIF è un lavoro per ffmpeg, non per yt-dlp — un WebM in loop di solito si avvicina di più a ciò che chi inviava intendeva.

I post con limite d'età e i contenuti sensibili sono il muro duro: l'impostazione vive nell'account, non nel comando. Accedi una volta via browser, attiva l'impostazione dei media sensibili, passa i cookies, e funziona — nessuna via di contorno senza cookies esiste, perché X controlla la sessione sul server. I post cancellati si comportano come ovunque: cancellato è cancellato, e i mirror che una volta tenevano copie hanno chiuso anni fa.

Domande frequenti

Perché un post con limite d'età su X fallisce?
I contenuti sensibili richiedono una sessione autenticata. Usa --cookies-from-browser con un account che ha quell'impostazione attiva.
Come scarico una GIF da X?
Sono video MP4, non GIF, e si scaricano come qualsiasi altro video. Converti dopo se ti serve una GIF vera.
Su X posso scegliere la qualità del video?
Sì. X pubblica più versioni: metti un tetto all'altezza dal menu della qualità, o elencale prima con -F.