gold-dl 2025.12.25

Library GoLD YouTube downloader (video / audio / shorts / playlists) with smart caching and auto quality handling

📹 gold-dl - The Simplest YouTube Downloader CLI

Telegram User Dev ~ @CB6BB

Enjoying my project? Please show your appreciation by starring it on GitHub! ⭐

[!NOTE] > gold-dl is built on top of pytubefix, make sure to have the latest version of pytubefix by running:

pip install --upgrade pytubefix

[!NOTE] Have a new feature? Please don't hesitate to tell me!

🤔 why gold-dl?

This command-line wizard lets you download YouTube videos or playlists straight from your Terminal, powered by Pytubefix. It works like a charm on Windows, Mac, and Linux, so you can rock it on any platform.

While other tools make you wade through a swamp of settings and configs, gold-dl keeps it simple. Just drop in your URL, and voilà! It’ll take you on a smooth ride to your favorite videos, no complex options needed—just fun downloading! 🔥

🛠️ Installation

Getting gold-dl up and running is a breeze! First, ensure you have Python installed. Just pop open your terminal and type:

python --version

If you see something like Python 3.x, you’re all set! If not, head over to Python's downloads page to grab it.

Once you’re good to go, install gold-dl with a single command:

pip install gold-dl --break-system-packages

And just like that, you’re ready to download some awesome videos! 🎉

📈 Upgrade

Stay in the loop with the latest features on GitHub! To upgrade your gold-dl tool, simply run:

pip install --upgrade gold-dl --break-system-packages

Then you’re all set to keep downloading from your Terminal! 🥳

🦸 Quick Start

Getting started with gold-dl is a piece of cake! Just use the following command style:

gold-dlp "YOUTUBE_LINK" [PATH]

[!NOTE] The [URL] is [Required] and it should be between ""
The [PATH] is optional—if you don’t specify one, it’ll save to your current terminal directory. Easy-peasy!

👨‍💻 Usage

Arguments

Arguments	Description
URL	The URL of the YouTube video. This argument is [Required].
PATH	The path to save the video. Defaults to the current working directory. [Optional]

Options

Option	Description
-v or --version	Displays the current version number.
-a or --audio	Download audio only, skipping prompts.
-f or --footage	Download video only, skipping prompts.

🕵️‍♂️ Examples

For lots of examples, check them out here! Take a deep dive and discover all the ways to use gold-dl. 🚀

🥰 Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you want to change. please follow the contributing guidelines

📎 License

This project is licensed under the MIT License.

📸 Screenshots

Download video with specify the save location

Chose what type you want to download

Chose what what resolution you want to download(if the type is video)

If you download a playlist, you can choose what video you want to download, or even all of them

Do not know how to use it? just type gold-dlp --help

⏳ Todo List

• Notification System
• Auto Update package if new version available
• Support Optional Numbering for Downloaded Playlist Videos
• Improve code health
• Support downloading sounds (mp3 format not a audio/mp4)
• Support Subtitles Download
• Support setting for downloading folder
• Download Thumbnails with Videos and Audio