SgithiDownloader 1.0.0

A tool to download YouTube videos and audio with embedded thumbnails.

sgithidownloader

A Python tool to download YouTube videos and audio in various high-quality formats with embedded thumbnails and metadata.

Features

• Download individual YouTube videos or entire playlists
• Support for multiple video formats (MP4, WebM, etc.)
• Convert and download audio in various formats (Opus, MP3, FLAC, AAC, etc.)
• Automatically embed video thumbnails as album art
• Include metadata (title, artist, album, date, description) in supported formats
• Crop thumbnails to square format for better display

Installation

Prerequisites

• Python 3.8 or higher
• FFmpeg (for audio processing)

Install FFmpeg

On Ubuntu/Debian:

sudo apt update
sudo apt install ffmpeg

On macOS:

brew install ffmpeg

On Windows: Download from ffmpeg.org and add to PATH.

Install the Package

git clone <your-repo-url>
cd OpusDownloader
pip install .

For development:

pip install -e .

Usage

Download a Single Video

sgithidownloader -s "https://www.youtube.com/watch?v=VIDEO_ID" -o /path/to/output/

Download a Playlist

sgithidownloader -p "https://www.youtube.com/playlist?list=PLAYLIST_ID" -o /path/to/output/

Download Audio

sgithidownloader -s "https://www.youtube.com/watch?v=VIDEO_ID" -f audio -af opus -o /path/to/output/

Options

• -s, --single URL: Download a single video
• -p, --playlist URL: Download all videos in a playlist
• -o, --output DIR: Output directory (default: current directory)
• -f, --format FORMAT: File format for video (mp4, webm, audio, etc.) (default: mp4)
• -af, --audio_format FORMAT: Audio format (best, aac, alac, flac, m4a, mp3, opus, vorbis, wav) (default: best)
• -l, --listFormats: List available audio formats and exit
• --help: Show help message

Examples

# Download a single video to the current directory
sgithidownloader -s "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

# Download a playlist to a specific folder
sgithidownloader -p "https://www.youtube.com/playlist?list=PLrAXtmRdnEQy4qtr5G1G8jQGzq9j9j9j" -o ~/Videos/

# Download audio in MP3 format
sgithidownloader -s "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -f audio -af mp3 -o ~/Music/

# List available audio formats
sgithidownloader -l

Dependencies

• yt-dlp: For downloading and extracting audio
• mutagen: For embedding metadata in audio files
• pytube: For playlist handling
• pillow: For image processing
• requests: For downloading thumbnails

License

MIT License - see LICENSE file for details.

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

Disclaimer

This tool is for personal use only. Respect YouTube's terms of service and copyright laws. The author is not responsible for misuse.