vd - High-Performance Video Downloader 🚀

vd is a lightweight, blazing-fast, and multi-threaded CLI video downloader written in Go. It supports parallel downloads using goroutines, format selection, playlist management, and much more.

🌟 Features

• Multi-threaded: Download multiple URLs or playlist items in parallel using -go.
• Cross-Platform: Works seamlessly on Windows, Linux, and macOS.
• Format Control: List and select specific video/audio formats.
• Post-processing: Extract audio, embed subtitles, metadata, and thumbnails (requires FFmpeg).
• Privacy & Security: Support for proxies, cookies (browser/file), and IPv4/IPv6 forcing.
• Smart Management: Skip existing files, record download history, and restrict filenames.

📦 Installation

Since vd is distributed via npm, you can install it globally on any system with Node.js installed:

npm install -g vb-go

🚀 Quick Start

Help menu

vd -h

Basic download:

vd "[https://www.youtube.com/watch?v=example](https://www.youtube.com/watch?v=example)"

Download multiple videos in parallel:

vd -go "URL1" "URL2" "URL3"

Download a playlist to a specific directory:

vd -P ./my-videos -yes-playlist "PLAYLIST_URL"

🛠️ Common Options

| Flag | Description | | ------------- | ------------------------------------------------------- | | -go | Download all provided URLs in parallel using goroutines | | -go-workers | Set max parallel workers (e.g., -go-workers 3) | | -f | Specify format (e.g., bestvideo+bestaudio) | | -x | Extract audio only (requires FFmpeg) | | -P | Set download directory path | | -F | List all available formats | | -j | Print JSON information |

📖 Examples

Extract MP3 audio from a video:

vd -x --audio-format mp3 "URL"

Download specific items from a playlist:

vd -I 1:5,10 "PLAYLIST_URL"

Force IPv4 and use a proxy:

vd -4 --proxy "socks5://127.0.0.1:1080" "URL"

⚙️ Requirements

• FFmpeg (Optional): Required for merging video/audio tracks, extracting audio, or embedding metadata.
• Node.js: Required for installation via npm.

License: MIT (LICENSE)

Built with ❤️ by Saimon