TikTok Downloader (Загрузчик видео с TikTok)

Мощное и доступное дополнение для NVDA, позволяющее скачивать видео с TikTok. Специально разработано для незрячих и слабовидящих пользователей с полной поддержкой скринридера.

Возможности

• Скачивание видео: Загружайте видео с TikTok в формате MP4
• Опция без водяного знака: Попытка скачать видео без водяного знака TikTok
• Выбор качества: Выбор между «Лучшее», 1080p, 720p, 480p или 360p
• Умное определение URL: Автоматически определяет URL TikTok из адресной строки браузера или буфера обмена
• Фоновые загрузки: Загрузки продолжаются в фоновом режиме, пока вы работаете в других приложениях
• Очередь загрузок: Добавляйте несколько видео в очередь и скачивайте их последовательно
• Отслеживание прогресса в реальном времени: Просмотр скорости загрузки, размера файла, оставшегося времени и процента выполнения
• Звуковые уведомления: Звуковая обратная связь при завершении или ошибке загрузки (настраивается)
• Авто-повтор: Автоматический повтор неудачных попыток загрузки (настраиваемое количество попыток)
• Статистика загрузок: Отслеживание общего количества загруженных видео
• Сохранение состояния: Прерванные загрузки сохраняются и могут быть возобновлены после перезапуска NVDA

Требования

• NVDA 2019.3 или новее
• Windows 10 или новее
• Убедитесь, что папка bin содержит файлы yt-dlp.exe, ffmpeg.exe и ffprobe.exe. (Они не включены в репозиторий для экономии места).

Установка

1. Скачайте последний файл .nvda-addon со страницы Releases
2. Откройте файл при запущенной NVDA
3. Подтвердите установку при запросе
4. При необходимости перезапустите NVDA

Ручная установка (для разработки)

1. Клонируйте этот репозиторий
2. Скачайте необходимые исполняемые файлы:
   • yt-dlp.exe
   • ffmpeg (essentials build — извлеките ffmpeg.exe и ffprobe.exe)
3. Поместите файлы в globalPlugins/tiktokDownloader/bin/
4. Скопируйте папку addon в каталог конфигурации пользователя NVDA (например, %APPDATA%\nvda\addons).

Использование

Открытие загрузчика

• Нажмите NVDA+Shift+T, чтобы открыть диалоговое окно TikTok Downloader
• Или перейдите в Меню NVDA → Сервис → TikTok Downloader…

Скачивание видео

1. Скопируйте URL видео из TikTok в буфер обмена (дополнение определит его автоматически)
2. Откройте загрузчик с помощью NVDA+Shift+T
3. URL должен быть автоматически подставлен; если нет, вставьте его вручную
4. Выберите желаемое качество
5. Отметьте «Пытаться удалить водяной знак», если нужно
6. Нажмите «Добавить в очередь загрузки» или клавишу Enter

Быстрая загрузка

Нажмите NVDA+Shift+Control+T, чтобы мгновенно начать загрузку видео TikTok из буфера обмена без открытия диалогового окна.

Управление загрузками

• Повторить: Повторить неудачную или остановленную загрузку
• Остановить: Остановить активную загрузку
• Удалить: Удалить загрузку из списка
• Открыть расположение файла: Открыть папку с завершённой загрузкой
• Очистить завершённые: Удалить все завершённые загрузки из списка
• Остановить все: Остановить все активные загрузки

Сочетания клавиш в списке загрузок

• Delete: Удалить выбранную загрузку
• Enter: Открыть расположение файла для завершённых загрузок

Настройка

Доступ к настройкам через Меню NVDA → Параметры → Настройки → TikTok Downloader:

Краткий список сочетаний клавиш

Поддерживаемые форматы URL

Дополнение поддерживает различные форматы URL TikTok:

• https://www.tiktok.com/@username/video/1234567890
• https://m.tiktok.com/...
• https://vm.tiktok.com/...
• https://vt.tiktok.com/...

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

• Использует yt-dlp для извлечения и загрузки видео
• Использует ffmpeg для склейки видео и конвертации форматов
• Загрузки обрабатываются в очереди с максимум 3 одновременными загрузками
• Состояние загрузок сохраняется в файле nvda_tiktok_downloader_state.json в домашнем каталоге пользователя
• Дополнение автоматически обновляет yt-dlp при запуске

Решение проблем

«yt-dlp.exe не найден» или «ffmpeg.exe не найден»

Убедитесь, что необходимые исполняемые файлы присутствуют в папке bin:
- globalPlugins/tiktokDownloader/bin/yt-dlp.exe
- globalPlugins/tiktokDownloader/bin/ffmpeg.exe
- globalPlugins/tiktokDownloader/bin/ffprobe.exe

Сбой загрузки с ошибкой

1. Убедитесь, что у вас есть активное подключение к интернету
2. Попробуйте обновить yt-dlp через Настройки → Проверить обновления yt-dlp
3. Некоторые видео могут быть ограничены по региону или являются приватными
4. Проверьте, корректен ли URL и существует ли ещё видео

Нет звуковых уведомлений

Проверьте, что в настройках дополнения включена опция «Воспроизводить звуковые уведомления».

Участие в разработке

Мы рады вашим вкладам! Пожалуйста, не стесняйтесь создавать issues или pull requests.

Лицензия

Этот проект лицензирован по лицензии GNU General Public License v2.0.

Благодарности

• NVDA — Бесплатный скринридер для Windows
• yt-dlp — Мощный загрузчик видео
• ffmpeg — Мультимедийный фреймворк

История изменений

Версия 1.0.0

• Первый выпуск
• Скачивание видео с TikTok в формате MP4
• Опция удаления водяного знака
• Выбор качества (Лучшее, 1080p, 720p, 480p, 360p)
• Умное определение URL из браузера и буфера обмена
• Очередь загрузок с одновременными загрузками
• Отображение прогресса в реальном времени
• Звуковые уведомления
• Авто-повтор при сбое
• Статистика загрузок
• Сохранение состояния загрузок