Usare FFmpeg con yt-dlp

Anche se yt-dlp è uno strumento estremamente potente per scaricare media, si affida molto a FFmpeg per gestire le attività di post-processing. Senza FFmpeg, perdi funzionalità critiche come l’unione di stream video e audio di alta qualità, la conversione dei file in formati diversi e l’incorporamento dei metadati.

Per ottenere il massimo da yt-dlp, è essenziale installare e configurare correttamente FFmpeg. Questa guida spiega come configurarlo e perché è necessario.

Installare FFmpeg e FFProbe

Perché yt-dlp utilizzi FFmpeg, deve avere accesso agli eseguibili binari standalone. Nota: installare wrapper Python come ffmpeg-python tramite pip non è sufficiente; servono le build reali del software.

Windows: scarica le ultime release. Il modo più semplice è estrarre ffmpeg.exe e ffprobe.exe e metterli nella stessa cartella del tuo yt-dlp.exe. In alternativa, puoi metterli in una cartella dedicata e aggiungere quella cartella al PATH di sistema.
Linux/macOS: di solito è meglio installare tramite package manager (es. apt install ffmpeg o brew install ffmpeg), che gestisce automaticamente il PATH.

Perché FFmpeg è essenziale per yt-dlp

Potresti notare che senza FFmpeg, yt-dlp non riesce a scaricare efficacemente video 1080p o 4K da siti come YouTube. Questo perché le piattaforme moderne spesso servono video HD e audio di alta qualità come stream separati.

Unione degli stream (muxing): yt-dlp scarica separatamente la migliore traccia video e la migliore traccia audio. Poi chiama FFmpeg per “muxare” (combinare) il tutto in un unico file (come MP4 o MKV). Senza FFmpeg, ti ritroveresti con due file separati o saresti costretto a scegliere una versione pre-combinata di qualità inferiore.
Conversione di formato: se ti serve un formato di output specifico (ad es. convertire un video musicale direttamente in MP3 o FLAC), FFmpeg gestisce il processo di transcodifica.
Metadati e capitoli: FFProbe (parte della suite FFmpeg) permette a yt-dlp di analizzare gli stream per assicurare che metadati, miniature e capitoli vengano incorporati correttamente.

Configurare il PATH di sistema

Se preferisci non tenere i binari nella stessa cartella di yt-dlp, devi assicurarti che il sistema operativo sappia dove trovarli. Questo si fa aggiungendo la cartella bin di FFmpeg alla variabile d’ambiente PATH.

Su Windows:

Cerca “Modifica le variabili d’ambiente di sistema”.
Clicca Variabili d’ambiente.
In “Variabili di sistema”, trova Path e clicca Modifica.
Aggiungi il percorso completo alla directory bin di FFmpeg (ad es. C:\Program Files\ffmpeg\bin).

Una volta configurato, riavvia il terminale. Puoi verificare che funzioni eseguendo ffmpeg -version. Se compaiono i dettagli della versione, yt-dlp lo rileverà e lo userà automaticamente.

Capire l’unione di video e audio

La potenza di yt-dlp sta nella selezione dei formati. Il comportamento predefinito è spesso bestvideo+bestaudio/best.

L’operatore +: indica al downloader di scaricare i migliori stream video e audio distinti.
L’unione: una volta scaricati, FFmpeg li combina. Ad esempio, può unire uno stream video WebM con uno stream audio Opus in un contenitore MKV.

Se i codec sono compatibili con il contenitore desiderato (ad es. MP4), FFmpeg copierà semplicemente gli stream (veloce). Se sono incompatibili, li ricodificherà (più lento, ma garantisce compatibilità). Puoi controllare questo comportamento usando i numerosi flag di selezione formato di yt-dlp.