🎬 MediaDl

A high-performance, open-source media downloader built for speed.

MediaDl provides a premium, "Linear-style" GUI for yt-dlp and FFmpeg. Download and process media from YouTube, TikTok, Facebook, and 1000+ other sites with a single click.

📥 Download Latest Release

..Downloading Videos and Music Made Simple..

---

✨ Key Features

📥 Effortless Downloading

• High Quality: Supports everything from 144p to 4K.
• Smart Queue: Easily manage multiple downloads in one organized list.
• Batch Paste: Add multiple links at once to save time.
• Live Stats: Real-time tracking of speed, file size, and progress.

🛠️ Built-in Media Tools

• Fast Converter: Switch between MP4, MP3, MKV, and AVI.
• Audio Extractor: Quickly turn any video into a high-quality MP3.
• Drag & Drop: Drop local files into the app to start processing instantly.
• Quick Actions: Instant "Open Folder" and "Play" shortcuts once finished.

🎨 Modern Design

• Clean Navigation: Simple sidebar to switch between Home, Tools, and Settings.
• Smart Input: A focused search bar that detects links from your clipboard.
• Sleek Layout: A professional, easy-to-read interface designed for speed.

---

📸 Interface

---

🌐 Supported Sites

Site	Video	Audio
YouTube	✅	✅
TikTok	✅	✅
Facebook	✅	✅
Instagram	✅	✅
Twitter / X	✅	✅
1000+ more	✅	✅

Full list: yt-dlp supported sites

---

🛠️ Build From Source (Windows)

Prerequisites

• git
• Node.js 18+ and npm
• WebView2 Runtime (usually already installed on Windows 10/11)

1. Clone the repository

git clone https://github.com/kevclint/MediaDl.git
cd MediaDl

2. Install JavaScript dependencies

npm install

3. Add required binaries to tools/

MediaDl expects these files:

• tools/yt-dlp.exe
• tools/ffmpeg.exe

Recommended for best YouTube compatibility on clean PCs (no Node/Deno installed):

• tools/node.exe (optional but strongly recommended)

Recommended sources:

• yt-dlp (official): https://github.com/yt-dlp/yt-dlp/releases/latest
• FFmpeg (official builds page): https://ffmpeg.org/download.html

Expected structure:

MediaDl/
`-- tools/
    |-- yt-dlp.exe
    `-- ffmpeg.exe
    `-- node.exe (optional)

4. Run in development mode

npm run dev

5. Build installer/executable

npm run build

Build artifacts are generated under:

• release/ (Windows installer and unpacked app)

Optional: quick tool checks

.\tools\yt-dlp.exe --version
.\tools\ffmpeg.exe -version
.\tools\node.exe --version

Troubleshooting builds

• yt-dlp.exe not found or ffmpeg.exe not found on other devices: Ensure both files exist in your local tools/ folder before running npm run build, then rebuild the installer.

---

📦 Built With

• Electron — Desktop app framework
• yt-dlp — Video downloading engine
• FFmpeg — Audio/video conversion

---

⚠️ Legal Notice

-This tool is intended for personal use only. Only download content you have permission to download. Respect copyright laws in your country. -Check out the MIT license for more info...

---

⭐ Support

If you find this useful, give it a star on GitHub! It helps others discover the project. 🙏