yt-dlp is a command-line tool that lets you obtain copies of videos from websites like YouTube, along with audio files, subtitles, and metadata. Think of it as a specialized piece of software that does one job very well: it communicates with video hosting platforms and retrieves the video files themselves so you can store them on your own computer.
Learn About Paying Your FGUA Bill Online →
The tool exists because sometimes you want permanent access to content—whether that's educational videos for offline viewing, music performances for archival purposes, or creators' work before it potentially disappears from the internet. YouTube removes videos regularly: creators delete their channels, copyright claims take videos down, or accounts get suspended. If you've found educational content that matters to you, having a local copy means you're not dependent on the platform keeping it available.
yt-dlp is the actively maintained successor to youtube-dl, a tool that hasn't been updated since 2021. The original project faced legal challenges and maintenance issues, which is why the community created yt-dlp as a continuation. It receives regular updates—sometimes multiple times per week—to handle changes that video platforms make to their systems. This matters because YouTube and other sites constantly modify how they serve videos specifically to prevent tools like this from working.
The tool operates through your computer's command line (also called terminal or command prompt). If you've never used a command line before, don't worry—this guide walks through the specific commands you need. You don't need to understand programming or be particularly tech-savvy. You're essentially typing instructions that tell the software "go fetch this video from that website and save it here on my computer."
Key takeaway: yt-dlp is a utility that retrieves video files from websites for offline storage. It requires command-line use but doesn't demand programming knowledge.
Your first step involves recognizing which operating system runs your computer, because yt-dlp installation differs slightly between Windows, macOS, and Linux. This matters because the instructions for each system use different tools and file locations. Trying to follow Windows instructions on a Mac, or vice versa, will lead to frustration and errors.
Free Guide to Pay by Plate Illinois Billing →
On Windows, you'll likely use either the Windows Subsystem for Linux (WSL) or install Python directly, then use Python's package manager to obtain yt-dlp. WSL creates a Linux environment within Windows, which many users prefer because Linux is the native environment where command-line tools like this originated. Alternatively, you can use standalone executable files that someone else has already compiled, which requires no setup at all—you just run the program.
On macOS, you have a few paths: install Homebrew (a package manager for Mac), then use it to get yt-dlp, or install Python and use Python's package manager directly. Many Mac users find Homebrew the smoothest route because it handles dependencies automatically. You can check if Homebrew is already installed by opening your Terminal and typing "brew --version."
Linux users typically have the easiest time because most Linux distributions come with Python pre-installed. You'll likely use your distribution's package manager (apt, dnf, pacman, etc.) or Python's pip tool directly.
To identify your operating system: On Windows, right-click "This PC" or "My Computer" and select "Properties." On Mac, click the Apple menu and select "About This Mac." On Linux, open Terminal and type "uname -s."
Key takeaway: Identify your operating system first, then choose the appropriate installation path—Windows users have multiple options, Mac users typically prefer Homebrew, and Linux users can use their native package managers.
Many yt-dlp installation methods require Python, a programming language that makes running tools like this possible. Even if you never write Python code, having Python installed on your system acts as the engine that runs yt-dlp. Python is free, open-source, and doesn't conflict with other software on your computer.
Free Guide to Mold Removal Methods for Walls →
On Windows, visit python.org and grab the latest version (currently Python 3.12 or 3.13). During installation, there's a crucial checkbox: "Add Python to PATH." This must be checked. PATH is a system setting that tells Windows where to look for programs. If Python isn't added to PATH, you'll get errors when trying to run yt-dlp from the command line. Run the installer and follow the prompts, making sure that PATH checkbox stays checked.
Verify the installation by opening Command Prompt (search "cmd" in your Windows menu) and typing "python --version." You should see something like "Python 3.12.1" printed back. If you get a "command not found" error, Python didn't get added to PATH—restart your computer and try again, or reinstall Python with that checkbox properly selected.
On macOS with Homebrew already installed, simply type "brew install python3" in Terminal. If Homebrew isn't installed, visit brew.sh and follow their installation instructions. The process takes a few minutes but requires just one command.
On Linux, check if Python is installed by typing "python3 --version" in Terminal. Most distributions include it. If not present, use your package manager: "sudo apt install python3" (Ubuntu/Debian), "sudo dnf install python3" (Fedora), or equivalent for your distribution.
After Python is installed, you need pip, which is Python's package manager—the tool that retrieves yt-dlp from repositories online. Modern Python versions include pip automatically. Test this by typing "pip --version" or "pip3 --version" in your command line. You should see version information. If pip isn't found, visit pip.pypa.io for repair instructions specific to your system.
Key takeaway: Python and pip are the foundation for most yt-dlp setups. Install Python first, verify it's in your system PATH, and confirm pip works before proceeding further.
With Python and pip ready, obtaining yt-dlp itself is straightforward. Open your command line (Command Prompt on Windows, Terminal on Mac/Linux) and type: "pip install yt-dlp" then press Enter. The system will download yt-dlp and install it automatically, which takes about a minute on any internet connection. You'll see text scrolling—this is normal. The process completes when you see a line saying "Successfully installed yt-dlp."
How to Delete Your Fitbit Account Guide →
Verify installation by typing "yt-dlp --version" in your command line. You'll see output like "2024.01.16" (the version number changes frequently as updates release). This confirms yt-dlp is ready to use.
To update yt-dlp whenever a new version releases, simply type "pip install --upgrade yt-dlp." Because YouTube frequently changes how it serves videos, staying current with updates matters. You might update every few weeks, though updates can happen several times per week.
Creating a dedicated folder for your videos keeps your computer organized. On Windows, open File Explorer and create a new folder like "C:\Users\YourName\Videos\yt-dlp-files." On Mac/Linux, open Terminal and type "mkdir ~/yt-dlp-downloads." Then navigate into that folder before running yt-dlp commands. This ensures downloaded videos land in one organized place rather than scattered across your computer.
For basic usage, the simplest command is: "yt-dlp [URL]" where you replace [URL] with an actual video link. For example: "yt-dlp https://www.youtube.com/watch?v=dQw4w9WgXcQ" downloads that specific video. The file saves in whatever folder your command line is currently pointing to. Most people navigate to their videos folder first, then run the command.
yt-dlp supports hundreds of websites beyond YouTube—including Vimeo, TikTok, Instagram, educational platforms, livestream archives, and many others. The same basic command works across nearly all of them. Check the official yt-dlp repository on GitHub for the complete list of supported sites.
Key takeaway: Installation via pip is one command. Verification takes seconds. Creating an organized folder for downloads
This guide is for general information only and is not medical, financial, legal, or other professional advice. For decisions specific to your situation, consult a qualified professional. See our Editorial Policy.