HuskyDownload — Пакетный загрузчик видео

📋 Описание проекта

HuskyDownload — это удобное графическое приложение для массовой загрузки видео из социальной сети ВКонтакте. Программа поддерживает пакетную обработку множества ссылок, отображает прогресс загрузки каждого файла и позволяет управлять процессом скачивания.

✨ Основной функционал

1. Пакетная загрузка видео

• Загрузка нескольких видео одновременно
• Поддержка списка ссылок (каждая с новой строки)
• Автоматическое использование cookies из Яндекс.Браузера для доступа к закрытым видео
• Сохранение видео в выбранную папку

2. Отображение прогресса

• Процент загрузки для каждого файла
• Статусы: «Ожидает», «Скачивание», «OK», «Ошибка»
• Визуальные индикаторы в списке файлов
• Информация о текущем процессе в строке состояния

3. Управление процессом

• Пауза и возобновление загрузки
• Автоматическая обработка ошибок
• Пропуск некорректных ссылок
• Контекстное меню с функциями буфера обмена

4. Современный интерфейс

• Темная тема оформления (Arc theme)
• Drag & Drop поддержка (можно перетаскивать файлы)
• Удобный список с автоскроллингом
• Адаптивный дизайн окна

🚀 Установка и запуск

🎯 Быстрый старт (Windows)

Проект имеет автоматизированную систему развертывания:

1. Установка (один раз):

setup.bat

Скрипт автоматически:

• Проверит наличие Python 3.8+
• Создаст виртуальное окружение
• Установит все зависимости

2. Запуск:

run.bat

💡 Подсказка: Просто дважды кликните на setup.bat для первичной установки, затем используйте run.bat для запуска.

Требования

• Python 3.8 или выше (указано в runtime.txt)
• Windows / Linux / macOS
• Яндекс.Браузер (для доступа к cookies)

Установка зависимостей (альтернативный способ)

1. Убедитесь, что Python установлен на вашем компьютере
2. Откройте командную строку (терминал) в папке проекта
3. Установите необходимые библиотеки:

pip install -r requirements.txt

Файл requirements.txt содержит все необходимые зависимости:

• yt-dlp — библиотека для загрузки видео с различных платформ
• ttkthemes — темы оформления для tkinter

Запуск программы

python vk_downloader_gui1.py

📖 Инструкция по использованию

Шаг 1: Выбор папки для сохранения

1. Нажмите кнопку «Выбрать папку для сохранения»
2. Выберите директорию, куда будут сохраняться видео

Шаг 2: Добавление ссылок на видео

Вставьте ссылки на видео ВКонтакте в текстовое поле одним из способов:

• Ручной ввод: Скопируйте и вставьте ссылки (каждая с новой строки)
• Контекстное меню: Правый клик → Вставить

Примеры корректных ссылок:

https://vk.com/video-123456789_456123456
https://vk.com/video123456?z=video-123456789_456123456

Шаг 3: Запуск загрузки

1. Нажмите кнопку «Скачать все»
2. Программа автоматически начнет загрузку видео по очереди
3. Прогресс каждого файла отображается в процентах

Шаг 4: Управление процессом

• Пауза: Нажмите кнопку «Пауза» для приостановки загрузки
• Продолжить: Нажмите кнопку «Продолжить» для возобновления

Статусы файлов

📁 Структура проекта

HuskyDownload/
├── vk_downloader_gui1.py  # Основной исполняемый файл
├── requirements.txt       # Список зависимостей
└── README.md             # Данная документация

⚙️ Технические особенности

Работа с cookies

Программа автоматически использует cookies из Яндекс.Браузера для доступа к видео:

• Поддержка приватных видео
• Доступ к видео, требующим авторизации
• Автоматическое извлечение cookies из профиля браузера

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

• Загрузка происходит в отдельном потоке
• GUI остается отзывчивым во время скачивания
• Безопасное обновление интерфейса через root.after()

Обработка ошибок

• Автоматический пропуск некорректных ссылок
• Логирование ошибок в консоль
• Продолжение работы при сбое отдельных файлов

🔧 Технические детали

• Язык программирования: Python 3
• Библиотека GUI: Tkinter + ttkthemes
• Загрузчик видео: yt-dlp
• Поддерживаемые платформы: Windows, Linux, macOS

⚠️ Возможные проблемы и решения

Проблема: Ошибка «ModuleNotFoundError: No module named ‘yt_dlp'»
Решение: Установите зависимости: pip install -r requirements.txt

Проблема: Не скачиваются приватные видео
Решение: Убедитесь, что вы авторизованы в Яндекс.Браузере под своим аккаунтом ВК

Проблема: Ошибка «Could not set theme ‘arc'»
Решение: Установите ttkthemes: pip install ttkthemes

Проблема: Видео скачивается с ошибкой
Решение: Проверьте корректность ссылки и доступность видео

💡 Советы по использованию

1. Массовая загрузка: Вставьте сразу много ссылок для пакетной обработки
2. Проверка ссылок: Убедитесь, что ссылки начинаются с http:// или https://
3. Пауза при ошибках: Если видео не скачивается, поставьте на паузу и проверьте ссылку
4. Контекстное меню: Используйте правый клик для быстрого копирования/вставки

📝 Формат ссылок

Программа поддерживает различные форматы ссылок ВКонтакте:

• https://vk.com/video-123_456
• https://vk.com/video123?z=video-123_456
• https://m.vk.com/video-123_456

📄 Лицензия

Этот проект создан для личного использования. Соблюдайте авторские права при загрузке контента.

👤 Автор

Разработано для удобной загрузки видео из ВКонтакте

⚖️ Отказ от ответственности

Используйте программу только для загрузки видео, на которые у вас есть права, или которые разрешены для скачивания авторами.