GetCoursePythonDownloader

Этот скрипт предназначен для загрузки видео с платформы GetCourse и основан на этом скрипте. Он загружает сегменты видео, объединяет их и конвертирует в формат MP4.

Особенности

• Асинхронная загрузка сегментов видео
• Прогресс-бары для отслеживания загрузки
• Автоматическое объединение сегментов
• Конвертация в MP4 с использованием FFmpeg
• Поддержка повторных попыток при ошибках загрузки и конвертации
• Поддержка Kinescope: автоматическое скачивание и объединение отдельных видео/аудио дорожек

Требования

• Python 3.7+
• FFmpeg
• yt-dlp (для скачивания Kinescope видео)
• Библиотеки Python: aiohttp, tqdm

Установка

1. Клонируйте репозиторий:

   git clone https://github.com/snhplayer/GetCoursePythonDownloader.git
   cd GetCoursePythonDownloader
   

2. Установите необходимые библиотеки:

   pip install aiohttp tqdm yt-dlp
   

3. Убедитесь, что FFmpeg установлен и доступен в системном PATH или находится в одной папке со скриптом.

Установка FFmpeg

Скрипту нужен установленный FFmpeg (должен быть доступен в PATH или лежать рядом с gcpd.py). Проверить установку можно командой ffmpeg -version.

Windows

Самый простой путь — через пакетный менеджер winget (Windows 10/11):

winget install --id Gyan.FFmpeg -e

Альтернативы:

• Chocolatey:

  choco install ffmpeg

• Scoop:

  scoop install ffmpeg

• Ручная установка (zip-архив): скачайте сборку FFmpeg для Windows со страницы загрузок FFmpeg (раздел Windows builds), распакуйте и добавьте папку bin в переменную окружения PATH.

Примечание: winget пакет Gyan.FFmpeg ставит официально рекомендуемую сборку; подробнее см. карточку пакета. Chocolatey и Scoop также предоставляют готовые бинарники.

Linux

Ubuntu / Debian

sudo apt update
sudo apt install ffmpeg
ffmpeg -version

FFmpeg доступен в официальных репозиториях Ubuntu/Debian (подробности на Launchpad/Debian Packages).

Альтернатива: Snap-пакет ffmpeg (удобно, но может отличаться по набору кодеков и изоляции): sudo snap install ffmpeg

Fedora

На Fedora «полная» сборка FFmpeg ставится из репозиториев RPM Fusion:

1. Подключить RPM Fusion (Free и Nonfree)

sudo dnf install \
  https://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm \
  https://download1.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-$(rpm -E %fedora).noarch.rpm

2. Установить FFmpeg

sudo dnf install ffmpeg

ffmpeg -version

Подробные инструкции по включению RPM Fusion есть в документации Fedora и на сайте RPM Fusion. Учтите, что в официальном репозитории Fedora есть урезанный пакет ffmpeg-free; для максимальной совместимости обычно используют пакет ffmpeg из RPM Fusion.

Arch Linux

sudo pacman -S ffmpeg
ffmpeg -version

Пакет доступен в официальном репозитории (extra), см. Arch Wiki и карточку пакета.

macOS

Рекомендуемый способ — Homebrew:

# если brew ещё не установлен: https://brew.sh
brew install ffmpeg
ffmpeg -version

Альтернативы:

• MacPorts:

  sudo port install ffmpeg

• Статические сборки для macOS доступны со страницы загрузок FFmpeg (раздел macOS).

---

Проверка установки

После установки выполните:

ffmpeg -version
ffprobe -version

Если команды не находятся, убедитесь, что путь к каталогу с бинарниками (ffmpeg, ffprobe) добавлен в PATH. Ссылки на официальные способы получения готовых сборок (Windows/macOS/Linux) приведены на странице загрузок FFmpeg.

Автоматический сбор ссылок с помощью Userscript

Для автоматического сбора ссылок на видео во время просмотра курсов используйте gcpd link collector — пользовательский скрипт (userscript), который работает в браузере с расширением Violentmonkey.

Установка Violentmonkey

1. Установите расширение Violentmonkey для вашего браузера:

   • Chrome/Edge
   • Firefox
   • Opera

2. После установки вы увидите иконку расширения на панели инструментов браузера.

Установка gcpd link collector

1. Откройте файл gcpd_link_collector.user.js из репозитория.

2. Кликните на иконку Violentmonkey в панели инструментов → нажмите на иконку "+" (Создать новый скрипт).

3. Скопируйте содержимое файла gcpd_link_collector.user.js и вставьте в редактор Violentmonkey.

4. Сохраните скрипт (Ctrl+S или Cmd+S).

Добавление собственных доменов

Если вы хотите использовать скрипт на других платформах GetCourse (не только на getcourse.ru или muzkursi.ru):

1. Откройте скрипт в редакторе Violentmonkey (кликните на иконку Violentmonkey → найдите "gcpd link collector" → нажмите "Редактировать").

2. Найдите в начале скрипта строки с директивами @match:

   // @match        *://getcourse.ru/*
   // @match        *://*.getcourse.ru/*
   // @match        *://*.muzkursi.ru/*

3. Добавьте новую строку с вашим доменом по аналогии:

   // @match        *://*.ваш-домен.ru/*

   Примеры:

   • Для конкретного домена: // @match *://school.example.ru/*
   • Для домена и всех поддоменов: // @match *://*.example.ru/*

4. Сохраните изменения (Ctrl+S или Cmd+S).

Теперь скрипт будет работать на добавленных вами доменах.

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

Скрипт автоматически собирает ссылки на видео при просмотре курсов на следующих платформах:

• getcourse.ru и его поддомены
• muzkursi.ru и его поддомены
• kinescope.io и его поддомены

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

• Скрипт перехватывает сетевые запросы и автоматически собирает ссылки на m3u8 плейлисты
• Для Kinescope автоматически собирает как видео, так и аудио дорожки
• Автоматически извлекает названия уроков со страниц

Управление через меню:

Кликните на иконку Violentmonkey → выберите нужную команду:

• Status: total X — показывает количество собранных ссылок
• Download gcpd links — скачать файл с собранными ссылками в формате для gcpd.py
• Clear collection and rescan — очистить коллекцию и пересканировать страницу
• Toggle debug mode — включить/выключить режим отладки
• Show debug stats — показать статистику работы скрипта
• Clear debug stats — очистить статистику

Формат выходного файла:

Скачанный файл gcpd_links_YYYYMMDD_HHMMSS.txt содержит:

• Для GetCourse: ссылки на плейлисты с автоматически собранными названиями уроков
• Для Kinescope: тройки строк (видео URL, аудио URL, название)

Этот файл можно сразу использовать с gcpd.py для пакетной загрузки:

python gcpd.py -f gcpd_links_20240101_120000.txt

Режим отладки

Если скрипт не собирает ссылки или работает некорректно:

1. Включите режим отладки через меню Violentmonkey
2. Откройте консоль браузера (F12 → Console)
3. Посмотрите логи с префиксом [GCPD Debug]
4. Используйте команды Show debug stats и Clear debug stats для анализа

Подробнее о создании и редактировании userscript'ов: Violentmonkey Guide

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

Запустите скрипт:

python gcpd.py

Следуйте инструкциям в командной строке:

1. Введите ссылку на плейлист.
2. Укажите имя выходного файла.

Дополнительные опции:

• --pd: Включить предварительную загрузку размеров файлов (по умолчанию отключена).

Пример:

python gcpd.py --pd {url}

• Возможность определить количество параллельных потоков

Пример: Меняя

MAX_PARALLEL_DOWNLOADS = 4 

на

MAX_PARALLEL_DOWNLOADS = 5

Мы, соотвественно, меняем количество параллельных потоков закгрузки с 4 на 5.

• -f: Указать файл где находятся ссылки плей-листов и имена выходных файлов

Пример:

python gcpd.py -f a.txt

a.txt

https://....
foo
https://....
foo2
https://....
foo3

Работа с Kinescope (отдельные видео/аудио дорожки)

Скрипт автоматически определяет ссылки Kinescope и объединяет отдельные дорожки.

Формат Kinescope:

https://kinescope.io/VIDEO_ID/media.m3u8?quality=720&type=video
https://kinescope.io/VIDEO_ID/media.m3u8?quality=720&type=audio&lang=und
output_filename

Как получить ссылки Kinescope:

1. Откройте видео в браузере
2. Откройте DevTools (F12) → вкладка Network
3. Найдите запросы к media.m3u8?quality=720&type=video и type=audio
4. Скопируйте полные URL

Интерактивный режим:

python gcpd.py
# Введите ссылку на видео дорожку
# Введите ссылку на аудио дорожку
# Введите имя выходного файла

Пример файла для пакетной загрузки:

python gcpd.py -f kinescope.txt

kinescope.txt:

https://kinescope.io/VIDEO_ID_1/media.m3u8?quality=720&type=video
https://kinescope.io/VIDEO_ID_1/media.m3u8?quality=720&type=audio&lang=und
video1_name
https://kinescope.io/VIDEO_ID_2/media.m3u8?quality=720&type=video
https://kinescope.io/VIDEO_ID_2/media.m3u8?quality=720&type=audio&lang=und
video2_name

Скрипт использует yt-dlp для скачивания полных потоков и автоматически объединяет их в один MP4 файл с помощью FFmpeg.

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

Если возникают проблемы с загрузкой или конвертацией, скрипт автоматически попытается повторить операцию. Если проблема сохраняется, проверьте:

1. Правильность ссылки на плейлист.
2. Наличие доступа к интернету.
3. Корректность установки FFmpeg и yt-dlp.
4. Свободное место на диске.
5. Для Kinescope: убедитесь, что используете полные ссылки с параметрами quality и type.

Вклад в проект

Если вы обнаружили ошибку или у вас есть предложения по улучшению, пожалуйста, создайте issue или pull request в репозитории проекта.