udown 0.0.2

A fast YouTube video downloader with parallel processing

UDown

A fast YouTube video downloader with parallel processing capabilities. Downloads audio and video streams simultaneously for optimal performance.

Features

• ⚡ Parallel Processing: Downloads audio and video streams simultaneously
• 📊 Performance Profiling: Detailed timing reports for download operations
• 🎯 High Quality: Downloads best available audio and video streams
• 📝 Caption Support: Optional subtitle/caption downloads
• 🔧 FFmpeg Integration: Automatic audio-video merging
• 🖥️ Cross-Platform: Works on Windows, macOS, and Linux

Installation

From PyPI (Recommended)

pip install udown

From Source

git clone https://github.com/dipanjal/udown.git
cd udown
pip install -e .

Prerequisites

• Python 3.8+
• FFmpeg: Required for audio-video merging

Installing FFmpeg

macOS

brew install ffmpeg

Ubuntu/Debian

sudo apt update
sudo apt install ffmpeg

Windows

Download from FFmpeg official website or install via Chocolatey:

choco install ffmpeg

Usage

Basic Usage

udown -o ~/Downloads [youtube_url]

Advanced Usage

# Download to custom directory
udown -o ~/Downloads [youtube_url]

# Download with captions
udown -c -o ~/Downloads [youtube_url]

# Enable debug mode with detailed timing
udown -d -o ~/Downloads [youtube_url]

# Combine options
udown -o ~/Videos -c -d [youtube_url]

Command Line Options

Option	Description
-o, --output	Output directory (default: ./downloads)
-c, --caption	Download captions/subtitles if available
-d, --debug	Enable debug mode with detailed timing
--version	Show version information
-h, --help	Show help message

Examples

# Download a video
udown -o ~/Downloads https://www.youtube.com/watch?v=dQw4w9WgXcQ

# Download with captions to Downloads folder
udown -c -o ~/Downloads https://www.youtube.com/watch?v=dQw4w9WgXcQ

# Debug mode to see performance metrics
udown -d -o ~/Downloads https://www.youtube.com/watch?v=dQw4w9WgXcQ

Performance

The parallel processing approach provides significant time savings:

• Sequential Download: Audio + Video + Merge = Total Time
• Parallel Download: Max(Audio, Video) + Merge = Reduced Time

Sample Output

Downloading: Example Video Title
Downloading Audio File
Downloading Video File
Video downloaded successfully to: ./downloads/Example Video Title.mp4

==================================================
DOWNLOAD PERFORMANCE REPORT
==================================================
Audio Took: 12.34 seconds
Video Took: 15.67 seconds
Merging Took: 2.45 seconds
Expected Duration: 30.46 seconds
Total Process Time: 18.23 seconds
==================================================
Time Saved: 12.23 seconds
==================================================

Development

Setup Development Environment

git clone https://github.com/dipanjal/udown.git
cd udown
make install

Running Tests

pytest

Code Formatting

black ytdl/

Architecture

udown/
├── ytdl/
│   ├── __init__.py      # Package initialization
│   ├── cli.py           # Command-line interface
│   ├── downloader.py    # Core download logic
│   ├── profiler.py      # Performance timing
│   └── utils.py         # Utility functions
├── setup.py             # Package setup
├── pyproject.toml       # Modern packaging config
└── README.md           # This file

How It Works

1. URL Validation: Validates YouTube URL format
2. Stream Analysis: Identifies best audio and video streams
3. Parallel Downloads: Downloads audio and video simultaneously
4. FFmpeg Merge: Combines streams into final video file
5. Performance Profiling: Tracks timing for optimization

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add 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

• pytubefix - YouTube data extraction
• FFmpeg - Audio/video processing

Support

• 📧 Email: [e-mail]
• 🐛 Issues: GitHub Issues
• 📖 Documentation: GitHub Wiki