Aller au contenu
yt-dlp

Installer yt-dlp sous macOS

Installez yt-dlp et ffmpeg sous macOS avec Homebrew ou pipx, et gardez-les à jour.

Cet article n'est pas encore traduit, il s'affiche donc en anglais. L'interface, elle, est dans votre langue.

1. Install yt-dlp

Homebrew is the path of least resistance and installs both tools in one line.

brew install yt-dlp ffmpeg

Without Homebrew, pipx keeps yt-dlp in its own environment so it cannot collide with anything else you have installed through Python.

pipx install yt-dlp

Avoid a bare pip install into the system Python: recent macOS releases push back on it, and when it does work it tends to break later for unrelated reasons.

2. Install ffmpeg

Included above if you used Homebrew. Otherwise install it separately — merging, MP3 extraction and embedding all depend on it.

brew install ffmpeg

3. Check it worked

yt-dlp --version
ffmpeg -version

If the shell cannot find yt-dlp after a pipx install, run pipx ensurepath and open a new terminal.

Cookies from Safari

--cookies-from-browser safari needs Full Disk Access for your terminal, granted in System Settings → Privacy & Security. Without it the read fails with a permissions error that does not mention the setting. Chrome and Firefox work without it.

Updating

brew upgrade yt-dlp     # Homebrew
pipx upgrade yt-dlp     # pipx

Questions fréquentes

macOS ne trouve pas yt-dlp après une installation avec pipx.
Lancez pipx ensurepath, puis ouvrez un nouveau terminal pour que le PATH mis à jour soit pris en compte.
Faut-il autre chose pour les cookies sous macOS ?
Seulement pour Safari : --cookies-from-browser safari exige l'accès complet au disque pour votre terminal, dans Réglages Système → Confidentialité et sécurité. Chrome et Firefox fonctionnent sans.
Comment mettre à jour yt-dlp ?
Un binaire autonome se met à jour avec yt-dlp -U. Installé via un gestionnaire de paquets, mettez-le à jour par ce même gestionnaire : l'auto-mise à jour refuse de toucher un fichier qui ne lui appartient pas. Mettre à jour résout plus de problèmes que n'importe quel flag.