🎵 YouTube Downloader (MP3 / MP4)

A fast and lightweight YouTube downloader powered by yt-dlp + ffmpeg + LAME
_{Download high-quality MP3 music or MP4 videos without using complex commands}

✅ Two simple modes:

• 🎧 MP3 Mode — Extracts and converts YouTube audio into high-quality MP3 files with thumbnail and metadata.
• 🎬 MP4 Mode — Downloads best video and audio, merges them into MP4 format automatically.

✅ Auto Dependency Check — Automatic dependency detection (yt-dlp, ffmpeg, lame).
✅ Smart Folder System — Auto-creates Downloads/Music and Downloads/Video directories.
✅ Metadata Support — Embeds title, artist, album, and thumbnail.
✅ Playlist Support — Works with both single videos and playlists.

This tool is a simple Windows batch script that automates the YouTube download workflow:

1. User selects audio or video mode and provides a YouTube URL.
2. yt-dlp downloads the YouTube streams.
3. ffmpeg merges audio and video or extracts sound only.
4. lame converts the audio to MP3 format.
5. Thumbnail and metadata are embedded automatically.

YouTube-Downloader/
├── yt-downloader.bat    ← Main script
├── yt-dlp.exe           ← YouTube downloader core
├── ffmpeg.exe           ← Video/audio merger & converter
└── Downloads/           ← Output folder
    ├── Music/
    └── Video/

1. Download or clone this repository.
2. Place the following files together in the same directory:

   yt-downloader.bat 
   yt-dlp.exe
   ffmpeg.exe
   

3. Double-click yt-downloader.bat to start.
4. Follow on-screen instructions:

   [1] Download music (MP3)
   [2] Download video (MP4)
   

5. Paste the YouTube video or playlist URL.
6. Wait for completion — files will appear in the Downloads folder.

• 💻 Works on Windows 10 / 11 with UTF-8 enabled Command Prompt.
• ⬆️ Keep yt-dlp and ffmpeg updated for best compatibility.
• ⚠️ Some videos may not allow thumbnail embedding due to YouTube restrictions.
• ⚖️ For personal use only — Do not use this tool for copyrighted material.
• 🚫 Avoid using folders with Chinese characters or spaces in the path — may cause path issues.

You can tweak some settings in the script to suit your needs:

💡 Example: To save downloads on Desktop:

set folder=%userprofile%\Desktop\YouTubeDownloads

📁 Place all .exe files in the same folder as the batch file.

===============================================
      YouTube Downloader (MP3 / MP4)
      Powered by yt-dlp + ffmpeg
===============================================

Please select a download mode:
[1] Download music (MP3)
[2] Download video (MP4)

Please enter option (1 or 2): 1
Please paste the YouTube URL:
https://www.youtube.com/watch?v=dQw4w9WgXcQ

===============================================
✅ Download Complete!
Files saved in: "Downloads"
===============================================

This project was built to make YouTube downloading simple and accessible.
No Python installation, no command-line knowledge needed — just run and enjoy.

🧩 "The best tools are the ones that make you forget you're using them."

This project is free for personal use and educational purposes.
Please comply with YouTube’s Terms of Service and local copyright laws.