Skip to content

Latest commit

 

History

History
262 lines (169 loc) · 13.1 KB

README_ru.md

File metadata and controls

262 lines (169 loc) · 13.1 KB
Raw
Logo

Twitch Downloader

Twitch VOD/Клип/Чат скачиватель и Чат рендер

Сообщить об ошибке

Пример рендера чата

example.mp4

Что эта программа может делать?

  • Скачивать Twitch VODs (записи)
  • Скачивать клипы с Twitch`а
  • Скачивать чат для VODs и клипов, в JSON со всей оригинальной информацией, a также в браузерный HTML файл, или обычный txt файл
  • Обновить содержание сгенерированного JSON чат файла с опцией сохранить в другом формате
  • Использовать сгенерированный JSON чат файл для рендера чата с смайликами Twitter Twemoji или Google Noto Color Emojis и BTTV, FFZ, 7TV статичныими и анимированными смайликами

Интерфейс

Windows WPF

Полная документация по WPF здесь

Функциональность

Windows WPF GUI имеет все основные а также жизненно необходимые функции:

  • Поставить в очередь несколько задач на скачивание/рендер для одновременного выполнения
  • Создать список задач для скачивания из списка ссылок vod/клипов
  • Поиск и загрузка нескольких VODs/клипов любого стримера не выходя из приложения

Поддержка нескольких языков

Windows WPF GUI доступен в нескольких языках благодаря сообществу переводчиков. Посмотрите Раздел локализации из WPF README для получения более подробной информации.

Темы

Windows WPF GUI поставляется с светлой и тёмной темой вместе с возможностью подстраиванием под системную тему. Программа также поддерживает пользовательские темы! Посмотрите Раздел тем из WPF README для получения более подробной информации.

Видео демонстрация

https://www.youtube.com/watch?v=0W3MhfhnYjk (старая версия, концепт тот же)

Linux?

Посмотрите twitch-downloader-gui на Гитхабе или на AUR для GUI оболочки для CLI под Linux.

MacOS?

GUI не доступен для MacOS пока что :(

CLI

Посмотрите полную документацию по CLI здесь

CLI кросс-платформенная и имеет основные функции программы. Она работает на Windows, Linux, и MacOs*.

*Протестированы были только Macs с процессором Intel

С помощью CLI, возможна автоматизация процесса с помощью внешних скриптов. Для примера ниже предоставлен .bat код который может быть открыт на Windows. Этот код скачивает VOD и его чат, затем рендерит его, всё от одной команды.

@echo off
set /p vodid="Напишите айди VOD: "
TwitchDownloaderCLI.exe videodownload --id %vodid% --ffmpeg-path "ffmpeg.exe" -o %vodid%.mp4
TwitchDownloaderCLI.exe chatdownload --id %vodid% -o %vodid%_chat.json -E
TwitchDownloaderCLI.exe chatrender -i %vodid%_chat.json -h 1080 -w 422 --framerate 30 --update-rate 0 --font-size 18 -o %vodid%_chat.mp4

Windows - Введение

  1. Зайдите в Releases и скачайте последнюю версию для Windows или сделайте сборку сами.
  2. Достаньте TwitchDownloaderCLI.exe.
  3. Закиньте его в папку которую вы хотите:
cd C:\folder\containing\TwitchDownloaderCLI
  1. Если у вас нету FFmpeg, вы можете установить его через Chocolatey package manager, или вы можете скачать его как standalone файл с ffmpeg.org или используя TwitchDownloaderCLI:
TwitchDownloaderCLI.exe ffmpeg --download
  1. Теперь вы можете начать использовать TwitchDownloaderCLI, например:
TwitchDownloaderCLI.exe videodownload --id <vod-id-here> -o out.mp4

Вы можете найти больше примеров комманд в CLI README.

Linux – Введение

  1. У некоторых дистрибутивов, таких как like Linux Alpine, отсутствуют шрифты для некоторых языков (Арабский, Персидский, Тайский и др.). Если у вас отсутствуют шрифты вам нужно установить семейство шрифтов такие как Noto или проверьте wiki страницу вашего дистрибутива про шрифты, там может быть есть команда установки для этого сценария, например такая есть у Linux Alpine.
  2. Убедитесь что fontconfig и libfontconfig1 установлены. apt-get install fontconfig libfontconfig1 напишите эту команда на Ubuntu чтобы установить.
  3. Зайдите в Releases и скачайте последнюю версию бинарного файла для Linux, получите AUR Package для Arch Linux, или сделайте сборку сами.
  4. Достаньте TwitchDownloaderCLI.
  5. Закиньте его в папку которую вы хотите:
cd directory/containing/TwitchDownloaderCLI
  1. Дайте бинарному файлу права:
sudo chmod +x TwitchDownloaderCLI
  1. a) Если у вас нет FFmpeg, вам надо установить его через пакетный менеджер вашего дистрибутива или через ffmpeg.org как standalone файл, также вы можете скачать его через TwitchDownloaderCLI:
./TwitchDownloaderCLI ffmpeg --download
  1. b) Если вы скачали его как standalone файл, вам также нужно дать ему права:
sudo chmod +x ffmpeg
  1. Теперь вы можете начать использовать TwitchDownloaderCLI, например:
./TwitchDownloaderCLI videodownload --id <vod-id-here> -o out.mp4

Вы можете найти больше примеров комманд в CLI README.

MacOS – Введение

  1. Если у вас Apple Silicon M-series процессор, удостоверьтесь что вы скачали arm64 бинарный файл, если же вы хотите использовать x64 бинарный файл на Apple Silicon он должен быть запущен через сессию терминала под Rosetta 2:
arch -x86_64 zsh
  1. Зайдите в Releases и скачайте последнюю версию бинарного файла для MacOS или сделайте сборку сами.
  2. Достаньте TwitchDownloaderCLI.
  3. Закиньте его в папку которую вы хотите:
cd directory/containing/TwitchDownloaderCLI
  1. Дайте бинарному файлу права:
chmod +x TwitchDownloaderCLI
  1. a) Если у вас нет FFmpeg, вам надо установить его через Homebrew package manager, или через ffmpeg.org как standalone файл, также вы можете скачать его через TwitchDownloaderCLI:
./TwitchDownloaderCLI ffmpeg --download
  1. b) Если вы скачали его как standalone файл, вам также нужно дать ему права:
chmod +x ffmpeg
  1. Теперь вы можете начать использовать TwitchDownloaderCLI, например:
./TwitchDownloaderCLI videodownload --id <vod-id-here> -o out.mp4

Вы можете найти больше примеров комманд в CLI README.

Делаем свою сборку

Требования

Инструкции сборки

  1. Клонируйте репозиторий:
git clone https://github.com/lay295/TwitchDownloader.git
  1. Откройте папку клонированного репозитория:
cd TwitchDownloader
  1. Восстановите решение:
dotnet restore
  • Non-Windows устройствам может понадобится указать проект для восстановления тоесть dotnet restore TwitchDownloaderCLI
  1. a) Собираем GUI версию:
dotnet publish TwitchDownloaderWPF -p:PublishProfile=Windows
  1. b) Собираем CLI версию:
dotnet publish TwitchDownloaderCLI -p:PublishProfile=<Профили>
  • Существующие профили: Windows, Linux, LinuxAlpine, LinuxArm, LinuxArm64, MacOS, MacOSArm64
  1. a) Зайдите в папку с GUI сборкой:
cd TwitchDownloaderWPF/bin/Release/net6.0-windows/publish/win-x64
  1. b) Зайдите в папку с CLI сборкой:
cd TwitchDownloaderCLI/bin/Release/net6.0/publish

Благодарности третьим лицам

Рендер чата рендерится с помощью SkiaSharp и HarfBuzzSharp © Microsoft Corporation.

Кодирование рендера чата и завершение загрузки видео выполнены с помощью FFmpeg © The FFmpeg developers.

Рендер чата может использовать Noto Color Emoji © Google and contributors.

Рендер чата может использовать Twemoji © Twitter and contributors.

Поставляемые FFmpeg бинарные файлы загружаются с gyan.dev © Gyan Doshi.

Бинарные файлы FFmpeg загружаемые во время работы приложения, скачиваются с помощью Xabe.FFmpeg.Downloader © Xabe.

Чат формата Html экспортируется используя шрифт Inter размещённый на Google Fonts API © Google.

Чтобы посмотреть полный список используемых внешних библиотек, посмотрите THIRD-PARTY-LICENSES.txt.

License

MIT

TwitchDownloader никак не связан с Twitch Interactive, Inc. или его аффилированным компаниям.