UltraDownloader 🚀 [EN]

Version 1.0.6: Now includes encrypted configuration storage and improved FFmpeg setup experience!

A powerful, user-friendly media downloader application for Windows that supports downloading videos and music from multiple platforms including YouTube, VK, and other music services.

📥 Download Latest Version

Download UltraDownloader.exe

✨ Features

📹 Video Downloading

• YouTube: Download videos in MP4 format with best available quality
• VK Video: Support for VK (VKontakte) video content
• Automatic organization: Downloads are sorted into organized folders

🎵 Music/Audio Downloading

• YouTube Music: Download individual tracks or entire playlists
• Multi-platform music support: Works with various music platforms (excluding VK music)
• MP3 conversion: Automatically converts audio to high-quality MP3 format (192kbps)

⚙️ Smart Configuration

• Persistent settings: Saves download directory and FFmpeg path between sessions
• First-run setup: Guided configuration on first launch
• Windows AppData integration: Stores configuration in %APPDATA%\UltraDownloader\
• Auto-updater: Built-in update checker with automatic download and installation
• Encrypted settings: All configuration data is stored securely with encryption

🎯 User Experience

• Real-time progress bars: Visual download progress with speed indicators
• File size display: Shows download size in MB during transfer
• Intuitive menu system: Easy navigation through numbered options
• Error handling: Clear error messages and recovery options

🚀 Installation & Setup

System Requirements

• Windows 10 or later
• FFmpeg
• Internet connection

First-Time Setup

1. Download the UltraDownloader.exe file
2. Run the executable (no installation required)
3. Follow the setup prompts:
   • Select your preferred download directory
   • You will be prompted to set FFmpeg path (can be skipped and configured later)

FFmpeg Setup (optional, all the necessary FFmpeg files are already in the release archive)

For audio conversion features:

1. On first launch, you will be prompted to set FFmpeg path (you can skip and configure later)
2. Alternatively, in UltraDownloader, select option d, then 1 to set the path
3. Or download FFmpeg from ffmpeg.org and extract to a folder

📖 How to Use

Main Menu Options

UltraDownloader v_._._
--------------
ffmpeg_dir: C:/ffmpeg/bin/ffmpeg.exe
save_dir: C:/Users/___/Videos
--------------
1. Download Video
2. Download Music
d. Change directories
u. Check for updates
q. Quit
Enter choice:

Downloading Videos

1. Select option 1
2. Paste the video URL when prompted
3. Watch the progress bar and wait for completion

Downloading Music

1. Select option 2
2. Choose download mode:
   • 1: Single track only
   • 2: Entire playlist/album
3. Paste the music URL
4. Audio will be converted to MP3 automatically

📁 File Organization

All downloads are saved in a structured format:

Your_Selected_Directory/
└── UD_Downloaded/
├── Video/
│ ├── YouTube Video Title.mp4
│ └── VK Video Title.mp4
└── Music/
├── Song Title.mp3
└── Playlist_Name/
├── Track 1.mp3
├── Track 2.mp3
└── ...

Checking for Updates (EN)

1. Select option u from the main menu
2. The AutoUpdater will check for new versions
3. Follow the prompts to download and install updates

⚠️ Important Notes

Legal Considerations

• Only download content you have permission to download
• Respect copyright laws and terms of service
• This tool is for personal use only

Limitations

• VK music is not supported
• Some platforms may have download restrictions
• Playlist downloading depends on source platform support

Troubleshooting

"ffmpeg.exe not found"

• Set FFmpeg path using option d in the main menu
• Or download FFmpeg from the official website

Download fails

• Check your internet connection
• Verify the URL is correct and accessible
• Ensure you have write permissions in the download directory

Progress bar issues

• The terminal window must remain open during downloads
• Do not resize the terminal window while downloading

🔧 Technical Details

• Built with: Python, yt-dlp, Tkinter, requests
• Configuration: Encrypted binary storage in %APPDATA%\UltraDownloader\secure_config.bin (legacy JSON config also supported)
• Dependencies: FFmpeg
• Platform: Windows (standalone EXE)

🔒 Configuration Protection

UltraDownloader stores its settings (download/FFmpeg paths and update-repository info) in an encrypted binary file rather than plain JSON. This isn't about hiding secrets — it's about protecting the app from accidental damage:

• Encrypted storage: Configuration is stored encrypted using Fernet symmetric encryption in %APPDATA%\UltraDownloader\secure_config.bin
• Tamper-resistant: The config can't be hand-edited in a text editor, so a stray character or bad path won't break the app — all changes go through the in-app menus
• Machine-bound keys: Encryption keys are derived from your system information (hostname, username, platform), so a config file can't be copy-pasted between machines and cause confusing mismatches

📄 License

MIT License — free use and modification of the code

Enjoy downloading with UltraDownloader! 🎉

Note: Always respect content creators and copyright holders when downloading media.

=============================================================

UltraDownloader 🚀 [RU]

Версия 1.0.6: Теперь включает зашифрованное хранилище конфигурации и улучшенную настройку FFmpeg!

Мощное и удобное приложение для загрузки мультимедиа для Windows, которое поддерживает загрузку видео и музыки с нескольких платформ, включая YouTube, VK и другие музыкальные сервисы.

📥 Скачать последнюю версию

Скачать UltraDownloader.exe

✨ Особенности

📹 Загрузка видео

• YouTube: Загрузка видео в формате MP4 с наилучшим доступным качеством
• VK Video: Поддержка видеоконтента VK (ВКонтакте)
• Автоматическая организация: Загрузки сортируются по организованным папкам

🎵 Загрузка музыки/аудио

• YouTube Music: Загрузка отдельных треков или целых плейлистов
• Поддержка мультиплатформенной музыки: Работает с различными музыкальными платформами (за исключением VK music).
• Преобразование MP3: Автоматически преобразует аудио в высококачественный формат MP3 (192 Кбит/с)

⚙️ Интеллектуальная настройка

• Постоянные настройки: Сохраняет каталог загрузки и путь к FFmpeg между сеансами.
• Настройка при первом запуске: Управляемая настройка при первом запуске
• Интеграция с Windows AppData: Сохраняет конфигурацию в %APPDATA%\UltraDownloader\
• Автообновление: Встроенная проверка обновлений с автоматической загрузкой и установкой
• Зашифрованные настройки: Все данные конфигурации хранятся в зашифрованном виде

🎯 Удобство работы с пользователем

• Индикаторы выполнения в реальном времени: Визуальный ход загрузки с индикаторами скорости
• Отображение размера файла: Показывает размер загружаемого файла в МБ во время передачи
• Интуитивно понятная система меню: Простая навигация по пронумерованным параметрам
• Обработка ошибок: Четкие сообщения об ошибках и варианты восстановления

🚀 Установка и настройка

Системные требования

• Windows 10 или более поздней версии
• FFmpeg
• Подключение к Интернету

Настройка при первом запуске

1. Загрузите файл UltraDownloader.exe
2. Запустите исполняемый файл (установка не требуется)
3. Следуйте инструкциям по установке:
   • Выберите предпочитаемый каталог загрузки
   • Будет предложено указать путь к FFmpeg (можно пропустить и настроить позже)

Настройка FFmpeg (необязательно, все нужные файлы FFmpeg уже есть в архиве релиза)

Для функций преобразования аудио:

1. При первом запуске вам будет предложено указать путь к FFmpeg (можно пропустить и настроить позже)
2. Альтернативно, в UltraDownloader выберите опцию d, затем 1 чтобы указать путь
3. Или загрузите FFmpeg из ffmpeg.org и извлеките в папку

📖 Как использовать

Пункты главного меню

UltraDownloader v_._._
--------------
ffmpeg_dir: C:/ffmpeg/bin/ffmpeg.exe
save_dir: C:/Users/___/Videos
--------------
1. Download Video
2. Download Music
d. Change directories
u. Check for updates
q. Quit
Enter choice:

Загрузка видео

1. Выберите опцию 1
2. Вставьте URL-адрес видео при появлении запроса
3. Следите за индикатором выполнения и дождитесь завершения

Загрузка музыки

1. Выберите опцию 2
2. Выберите режим загрузки:
   • 1: только один трек
   • 2: Весь список воспроизведения/альбом
3. Вставьте URL-адрес музыки
4. Аудио будет автоматически преобразовано в MP3

📁 Организация файлов

Все загруженные файлы сохраняются в структурированном формате:

ваш_выбранный_директорий/
└── UD_Downloaded/
├── Видео/
│ ├── Название видео на YouTube.mp4
│ └── Название видео на VK.mp4
└── Музыка/
├── Название песни.mp3
└── Название плейлиста/
├── Трек 1.mp3
├── Трек 2.mp3
└── ...

Проверка обновлений (RU)

1. Выберите опцию u в главном меню
2. AutoUpdater проверит наличие новых версий
3. Следуйте инструкциям для загрузки и установки обновлений

❗️ Важные замечания

Юридические соображения

• Загружайте только тот контент, на который у вас есть разрешение
• Соблюдайте законы об авторском праве и условия предоставления услуг
• Этот инструмент предназначен только для личного использования

Ограничения

• Музыка ВКОНТАКТЕ не поддерживается
• На некоторых платформах могут быть ограничения на загрузку
• Загрузка плейлистов зависит от поддержки исходной платформы

Устранение неполадок

"ffmpeg.exe не найдено"

• Укажите путь к файлу FFmpeg, используя опцию d в главном меню
• Или загрузите файл FFmpeg с официального веб-сайта

Ошибка загрузки

• Проверьте подключение к Интернету
• Убедитесь, что URL указан правильно и доступен
• Убедитесь, что у вас есть разрешения на запись в каталог загрузки

Проблемы с индикатором выполнения

• Окно терминала должно оставаться открытым во время загрузки
• Не изменяйте размер окна терминала во время загрузки

🔧 Технические подробности

• Создано с использованием: Python, yt-dlp, Tkinter, requests
• Конфигурация: зашифрованное бинарное хранилище в %APPDATA%\UltraDownloader\secure_config.bin (также поддерживается устаревший JSON-конфиг)
• Зависимости: FFmpeg
• Платформа: Windows (автономный исполняемый файл)

🔒 Защита конфигурации

UltraDownloader хранит настройки (пути к загрузкам/FFmpeg и данные репозитория для обновлений) в зашифрованном бинарном файле, а не в обычном JSON. Это не про сокрытие секретов — это защита приложения от случайной порчи настроек:

• Зашифрованное хранилище: Конфигурация хранится в зашифрованном виде с использованием симметричного шифрования Fernet, в %APPDATA%\UltraDownloader\secure_config.bin
• Защита от случайных правок: Файл конфигурации нельзя отредактировать вручную в текстовом редакторе — случайный лишний символ или неверный путь не сломает программу, все изменения проходят через меню приложения
• Ключи привязаны к машине: Ключи шифрования создаются на основе информации о вашей системе (имя хоста, имя пользователя, платформа), поэтому файл конфигурации нельзя просто скопировать на другой компьютер и получить путаницу из-за несовпадений

📄 Лицензия

Лицензия MIT — свободное использование и модификация кода

Наслаждайтесь загрузкой с UltraDownloader! 🎉

Примечание: Всегда уважайте создателей контента и правообладателей при загрузке мультимедийных материалов.