Lumi 🎵

Comfortable, simple, and fast audio & video downloader with a beautiful interface and no unnecessary clutter, supporting downloads from 1000+ sites thanks to yt-dlp.

---

⚡ Features Summary

• 🎬 Audio & Video: Download videos and extract audio in MP3, M4A, OPUS, WAV.

• 🎥 Quality Modes: Best (4K/1080p) · Medium (720p) · Worst (min size).

• 🌐 Proxy & Cookies: Supports proxy downloads and cookies for restricted content.

• 🎨 Modern UI: Clean interface with Light / Dark themes and animated GIF backgrounds.

• 🌍 Localization: 20 languages · English primary · ~85% translated.

• 🛡️ Stable & Safe: Isolated temp folders with auto-cleanup.

• 🧪 System Checks: Auto-check yt-dlp updates and FFMPEG.

Localization

• 

Light theme interface ☀️

Dark theme interface 🌙

Settings panel ⚙️

---

🛠️ Technical Stack

Component	Technology	Description
Language	Python 3.10+	Core application logic
GUI	PySide6 (Qt)	Interface
Core	yt-dlp	Download engine
Media	FFmpeg	Audio/video conversion and extraction

---

⚙️ Customization

• You can add any custom theme: just drop your favorite GIF file into assets/gifs and name it according to the theme, e.g., white.gif / black.gif.
• Add or modify languages in src/strings: take one of the existing files, copy it, translate the String keys = values for your language, and it will appear in the settings.

---

🚀 Installation & Run

Requirements:

• FFmpeg - either install it system-wide, or simply put the FFmpeg folder into \src\ffmpeg; the program will detect it automatically.

Supported: Windows / macOS / Linux (tested on Windows)

Installation & Run:

1. Clone the repository:

git clone https://github.com/eug0x/lumi-yt-dlp-gui

2. Install dependencies:

pip install -r requirements.txt

3. Run

python main.py