Надоело каждый раз лезть в терминал, чтобы скачать видео с YouTube? Мне тоже. Поэтому я сделал нормальный GUI для yt-dlp - без лишних кнопок, с современным интерфейсом и чтобы просто работал. Код на GitHub, готовая сборка тоже есть.

Зачем вообще это делать?

Да, yt-dlp крутой - качает с кучи сайтов, быстрый, надёжный. Но блин, каждый раз набирать команды в консоли - это не для всех. Особенно когда нужно быстро скачать что-то и не париться с параметрами.

Посмотрел на существующие GUI - одни выглядят как из 2005 года, другие напичканы настройками, которые 99% пользователей никогда не трогают. Захотелось сделать что-то простое: вставил ссылку, выбрал качество, скачал. Всё.

Что хотел получить:

• Простоту - минимум кликов от ссылки до файла

• Нормальный вид - тёмная тема, без уродских кнопок из 90-х

• Скорость - никаких тормозов и зависаний

• Работает везде - Windows точно, остальные ОС в планах

• Не требует установки - скачал exe и пользуешься

Что в итоге получилось

Интерфейс работает по принципу "от простого к сложному":

1. Стартовая страница - только поле для ссылки, ничего лишнего

2. Превью - показываем видео, даём выбрать качество

3. Скачивание - прогресс-бар и всякая полезная инфа

Стартовая страница

Превью видео

Прогресс загрузки

На чём писал

CustomTkinter - почему именно он

Долго выбирал между разными вариантами. В итоге остановился на CustomTkinter - это такая современная обёртка над обычным Tkinter.

Плюсы:

• Выглядит нормально сразу из коробки

• Плавные анимации есть

• Совместим с обычным Tkinter

• Активно развивается

Что ещё рассматривал:

• PyQt/PySide - мощно, но лицензия для коммерции геморрой

• Kivy - больше для мобилок заточен

• Electron - для простого даунлоадера это перебор

• Обычный tkinter - работает, но выглядит как поделка

Как организовал код

Сразу решил не лепить всё в одну кучу, а разложить по папкам:

src/ytdlp_gui/
├── core/                    # Вся логика работы
│   ├── download_manager.py  # Качает файлы
│   ├── format_detector.py   # Разбирается с форматами
│   ├── settings_manager.py  # Настройки
│   └── cookie_manager.py    # Куки для обхода блокировок
├── gui/                     # Интерфейс
│   ├── main_window.py       # Главное окно
│   └── components/          # Отдельные части UI
└── utils/                   # Всякие полезности
    ├── logger.py           # Логи
    └── notifications.py    # Уведомления

Зачем так заморачивался:

• Проще искать баги - каждая штука в своём файле

• Можно тестировать части по отдельности

• Если захочу что-то добавить, не придётся ковыряться во всём коде

• Другим разработчикам будет понятно, что где лежит

Как это работает изнутри

Менеджер загрузок

Основная фишка - DownloadManager. Он умеет:

Качать в фоне и не тормозить интерфейс:

def _download_worker(self, download_item: DownloadItem):
    """Отдельный поток для скачивания"""
    try:
        ydl_opts = self._prepare_ydl_options(download_item)

        # Подключаем отслеживание прогресса
        ydl_opts['progress_hooks'] = [
            lambda d: self._progress_hook(d, download_item.id)
        ]
        ydl_opts['postprocessor_hooks'] = [
            lambda d: self._postprocessor_hook(d, download_item.id)
        ]

        with yt_dlp.YoutubeDL(ydl_opts) as ydl:
            ydl.download([download_item.url])
    except Exception as e:
        self._handle_download_error(e, download_item)

Обновлять интерфейс по ходу дела:

def add_progress_callback(self, download_id: str, callback: Callable):
    """Подписаться на обновления прогресса"""
    if download_id not in self.progress_callbacks:
        self.progress_callbacks[download_id] = []
    self.progress_callbacks[download_id].append(callback)

def _notify_progress_change(self, download_id: str):
    """Сказать интерфейсу, что что-то изменилось"""
    if download_id in self.progress_callbacks:
        for callback in self.progress_callbacks[download_id]:
            try:
                callback()
            except Exception as e:
                self.logger.error(f"Callback error: {e}")

Определение качества видео

FormatDetector разбирается, какие форматы доступны, и сортирует их по качеству:

def _calculate_quality_score(self, fmt: Dict) -> int:
    """Считаем очки качества для сортировки"""
    score = 0

    # Очки за разрешение
    height = fmt.get('height', 0) or 0
    if height >= 2160:    # 4K
        score += 1000
    elif height >= 1440:  # 1440p
        score += 800
    elif height >= 1080:  # 1080p
        score += 600
    # ... и так далее

    # Очки за битрейт
    tbr = fmt.get('tbr', 0) or 0
    score += min(tbr, 500)  # Чтобы не было совсем диких значений

    # Бонусы за хорошие кодеки
    vcodec = fmt.get('vcodec', '')
    if 'av01' in vcodec:      # AV1
        score += 50
    elif 'vp9' in vcodec:     # VP9
        score += 30
    elif 'h264' in vcodec:    # H.264
        score += 20

    return score

Как устроен интерфейс

Сделал по принципу "показываем только то, что нужно сейчас":

1. Стартовая - только поле для ссылки

2. После вставки ссылки - грузим инфо о видео

3. Превью - показываем видео и даём выбрать настройки

4. Скачивание - прогресс и всякие детали

Каждый экран - отдельный компонент:

• SimpleURLInputFrame - ввод ссылки

• VideoPreviewFrame - превью и настройки

• ProgressDisplayFrame - прогресс скачивания

Проблемы, с которыми столкнулся

YouTube и его капризы

Самая большая головная боль - получить нормальное название видео. YouTube ведёт себя по-разному в зависимости от времени, региона, есть ли VPN. Иногда вместо названия получаешь какую-то фигню.

Решил парсить HTML напрямую:

def _extract_title_from_html(self, url: str) -> Optional[str]:
    """Берём название прямо со страницы"""
    try:
        headers = {
            'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36',
            'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
            # Специально не указываем язык, чтобы получить оригинал
        }

        response = requests.get(url, headers=headers, timeout=10)

        # Ищем название в разных местах
        patterns = [
            r'<meta property="og:title" content="([^"]+)"',
            r'<meta name="title" content="([^"]+)"',
            r'"title":"([^"]+)"',
        ]

        for pattern in patterns:
            match = re.search(pattern, response.text)
            if match:
                return html.unescape(match.group(1))

    except Exception as e:
        self.logger.error(f"Не смог вытащить название: {e}")

    return None

Обход блокировок через куки

Чтобы обойти всякие региональные блокировки, тащу куки из браузера:

def get_cookie_options(self, url: str = None) -> Dict[str, Any]:
    """Берём куки из браузера для yt-dlp"""

    # Для разных сайтов разные браузеры работают лучше
    site_browsers = self.site_browser_preferences.get(
        self._extract_domain(url),
        self.browser_priority
    )

    for browser in site_browsers:
        if self._is_browser_available(browser):
            return {
                'cookiesfrombrowser': (browser, None, None, None)
            }

    return {}

Многопоточность в Tkinter

Tkinter не умеет в асинхронность из коробки, поэтому пришлось городить threading + callback'и:

def _progress_hook(self, d: Dict, download_id: str):
    """Хук для обновления прогресса (работает в фоновом потоке)"""
    try:
        download_item = self.get_download_item(download_id)
        if not download_item:
            return

        if d['status'] == 'downloading':
            # Обновляем данные
            download_item.progress = (d.get('downloaded_bytes', 0) /
                                    d.get('total_bytes', 1)) * 100
            download_item.speed = self._clean_display_string(d.get('_speed_str', ''))

            # Говорим интерфейсу обновиться
            self._notify_progress_change(download_id)

    except Exception as e:
        self.logger.error(f"Ошибка в progress hook: {e}")

А интерфейс подписывается на изменения и обновляется в основном потоке:

def update_progress(self, download_item):
    """Обновляем прогресс-бар (в основном потоке)"""
    if download_item:
        # Обновляем полоску прогресса
        progress = download_item.progress / 100.0
        self.progress_bar.set(progress)

        # Обновляем текст
        self.percentage_label.configure(text=f"{download_item.progress:.1f}%")
        self.speed_label.configure(text=f"Скорость: {download_item.speed}")

Уведомления

Сделал всплывающие уведомления с анимацией:

class ToastNotification(ctk.CTkToplevel):
    """Всплывающее уведомление"""

    def show_animation(self):
        """Плавно появляемся"""
        # Начинаем невидимыми
        self.attributes('-alpha', 0.0)

        # Постепенно становимся видимыми
        for i in range(20):
            alpha = i / 20.0
            self.attributes('-alpha', alpha)
            self.update()
            time.sleep(0.01)

    def close_animation(self):
        """Плавно исчезаем"""
        for i in range(20, 0, -1):
            alpha = i / 20.0
            self.attributes('-alpha', alpha)
            self.update()
            time.sleep(0.01)

        self.destroy()

Сборка в exe

Чтобы не заставлять людей ставить Python, собираю всё в один exe файл через PyInstaller:

Автоматическая сборка

def create_pyinstaller_spec():
    """Создаём spec-файл для PyInstaller"""

    hidden_imports = [
        "customtkinter",
        "yt_dlp",
        "PIL._tkinter_finder",
        "tkinter",
        "sqlite3",
        "threading",
        "psutil"
    ]

    # Подключаем ресурсы
    datas = [
        ("src", "src"),
        ("assets", "assets") if Path("assets").exists() else None
    ]
    datas = [d for d in datas if d]  # Убираем пустые

    # Генерим spec-файл
    spec_content = f'''
a = Analysis(
    ['main.py'],
    pathex=['src'],
    datas={datas!r},
    hiddenimports={hidden_imports!r},
    # ... остальные настройки
)
'''

Проблемы при сборке

Проблема: CustomTkinter не может найти свои файлы в exe

Решение: Прописываем пути явно:

# В spec-файле
datas=[
    ('venv/Lib/site-packages/customtkinter', 'customtkinter'),
]

Проблема: yt-dlp пытается обновиться через интернет

Решение: Отключаем обновления:

ydl_opts = {
    'no_check_certificate': True,
    'call_home': False,  # Не проверять обновления
}

Сборка под разные ОС

Скрипт сам определяет систему и делает нужный архив:

def create_archive():
    """Создаём архив для раздачи"""
    system = platform.system().lower()

    if system == "windows":
        exe_name = f"{APP_NAME}.exe"
        archive_format = "zip"
    elif system == "darwin":  # macOS
        exe_name = APP_NAME
        archive_format = "zip"
    else:  # Linux
        exe_name = APP_NAME
        archive_format = "gztar"

    # Архив с версией и платформой в названии
    archive_name = f"{APP_NAME}-v{APP_VERSION}-{system}-{platform.machine()}"

Что в итоге

Что работает

• ✅ Нормальный современный интерфейс

• ✅ Быстро качает без лишней обработки

• ✅ Поддерживает кучу сайтов через yt-dlp

• ✅ Работает на Windows (на других ОС пока не тестил)

• ✅ Готовый exe файл

• ✅ Уведомления и обработка ошибок

• ✅ Проверено на YouTube и ВКонтакте - всё ок

• ⚠️ Надо протестить на macOS и Linux

• ⚠️ Проверить работу с другими сайтами из списка yt-dlp

Цифры:

• Размер: ~27MB со всеми зависимостями

• Запуск: 2-3 секунды на нормальном компе

• Память: ~55MB когда просто висит

• Форматы: MP4 для видео, MP3 для аудио

Что планирую добавить

1. Выбор папки для сохранения - пока всё сохраняется на рабочий стол

2. Субтитры - скачивание субтитров в разных форматах

3. Тестирование на других ОС - проверить работу на macOS и Linux

4. Больше сайтов - протестить Одноклассники, Rutube, TikTok и прочие

Выводы

Делать GUI для консольной утилиты - интересная задачка. Главное - не переборщить с функциями и сделать так, чтобы было удобно пользоваться. CustomTkinter оказался отличным выбором: выглядит современно, работает быстро, не такой тяжёлый как Qt и не такой монстр как Electron.

Что понял в процессе:

• Архитектура важна - если сразу всё разложить по полочкам, потом легче добавлять новые фичи

• Простота рулит - лучше сделать 3 кнопки, которые работают, чем 30, которые никто не использует

• Многопоточность в GUI - боль - но без неё интерфейс тормозит

• Тестирование на разных ОС критично - что работает на Windows, может не работать на Linux

Полезные ссылки:

• Исходный код

• Готовая сборка

• CustomTkinter

• yt-dlp

В общем, Python + CustomTkinter - хорошая связка для десктопных приложений. Если думаете над GUI для Python - попробуйте.