Skip to main content

A simple YouTube video downloader

Project description

YouTube Video Downloader (yt-dl-easy)

A simple, user-friendly command-line tool to download YouTube videos with progress tracking. Built on top of yt-dlp with a simplified interface.

Features

  • 🚀 Simple command-line interface
  • 📊 Real-time download progress bar
  • 🎥 Support for various video resolutions
  • 📁 Custom output directory
  • 📝 Video information display (title, duration, views)
  • ⚡ Fast downloads using yt-dlp backend

Installation

You can install the package directly from PyPI:

pip install yt-dl-easy

Or install from source:

git clone https://github.com/yourusername/youtube_downloader.git
cd youtube_downloader
pip install .

Usage

After installation, you can use the yt-dl command from anywhere in your terminal:

Basic Usage

Download a video with best quality:

yt-dl "https://www.youtube.com/watch?v=VIDEO_ID"

Advanced Options

  1. Download with specific resolution:
yt-dl "https://www.youtube.com/watch?v=VIDEO_ID" --resolution 720p
  1. Specify output directory:
yt-dl "https://www.youtube.com/watch?v=VIDEO_ID" --output-dir ~/Downloads/videos

Available Options

  • --resolution: Video resolution (e.g., "720p", "1080p", or "best")
  • --output-dir: Directory to save downloaded videos (default: "downloads")

Requirements

  • Python 3.6 or higher
  • yt-dlp
  • tqdm (for progress bar)

Development

Want to contribute? Great! Here's how you can help:

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Support

If you encounter any issues or have suggestions, please open an issue on GitHub.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

yt_dl_easy-0.1.1.tar.gz (5.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

yt_dl_easy-0.1.1-py3-none-any.whl (6.5 kB view details)

Uploaded Python 3

File details

Details for the file yt_dl_easy-0.1.1.tar.gz.

File metadata

  • Download URL: yt_dl_easy-0.1.1.tar.gz
  • Upload date:
  • Size: 5.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.1

File hashes

Hashes for yt_dl_easy-0.1.1.tar.gz
Algorithm Hash digest
SHA256 88aa58679f94bc6b37ea8adfb37ca590ac574f70c2c5f27da307bfa4fc9c4472
MD5 0c1add01af871a1af751ce131897f870
BLAKE2b-256 3c29c3263d3464787502f6d9b60a6808c26085679ee88aae75eeb1656b38a347

See more details on using hashes here.

File details

Details for the file yt_dl_easy-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: yt_dl_easy-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 6.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.1

File hashes

Hashes for yt_dl_easy-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 bcc607e0bfa7e30fecc839775b51440459276e5570102f04787c3a052bbe7858
MD5 36a23f63eb0a195776bdeccad4a25ffc
BLAKE2b-256 004af2f68ec4c45ccc6eeed945f7124aaf3f1c3b1c613f313d64db713a6c4410

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page