Skip to content

Latest commit

 

History

History
218 lines (166 loc) · 9.8 KB

README_ptbr.md

File metadata and controls

218 lines (166 loc) · 9.8 KB
Raw
Logo

Twitch Downloader

Baixador de VOD/Clip/Chat da Twitch e Renderizador de Chat

Report Bug

Este arquivo Readme pode estar desatualizado, considere lê-lo em inglês

Exemplo do Chat Renderizado

example.mp4

O quê ele pode fazer?

  • Baixar VODs da Twitch
  • Baixar Clips da Twitch
  • Baixar o chat para VODs e Clips, seja em um arquivo JSON com todas as informações originais, um arquivo de browser HTML, ou um arquivo de texto normal
  • Atualizar os conteúdos de um arquivo do chat em JSON gerado préviamente com uma opção para salvar em outro formato
  • Usar um arquivo do chat em JSON gerado préviamente para renderizar o chat com o Twitter Twemoji ou Google Noto Color emojis e emotes BTTV, FFZ, 7TV estáticos e animados

GUI

Windows WPF

Veja a documentação completa do WPF aqui.

Funcionalidade

O GUI do Windows WPF implementa todas as principais funcionalidades do programa acompanhado com umas funcionalidades extras de conveniência:

  • Programe múltiplos trabalhos de baixar/renderizar para que funcionem simultâneamente
  • Criar uma lista de arquivos para baixar por uma lista de links de vods/clips
  • Buscar e baixar múltiplos VODs/clips de qualquer streamer sem sair do aplicativo

Suporte à Múltiplas línguas

O GUI do Windows WPF está disponível em múltiplas linguagens graças à traduções da comunidade. Veja a Sessão de localização do WPF README para mais detalhes.

Tema

O GUI do Windows WPF vêm com tanto o tema claro como o escuro, junto de uma opção para atualizar automaticamente de acordo com o tema do Windows. Ele também suporta temas criados pelo usuário! Veja a Sessão de Tema dos WPF README para mais detalhes.

Demonstração em Vídeo

https://www.youtube.com/watch?v=0W3MhfhnYjk (versão mais antiga, mesmo conceito)

Linux?

Veja twitch-downloader-gui no github ou no AUR para um GUI wrapper para o CLI Linux .

MacOS?

Nenhum GUI disponível pro MacOS até o momento :(

CLI

Veja a documentação completa do CLI aqui.

O CLI é cross-platform e implementa as principais funcionalidades do programa. Funciona no Windows, Linux, e MacOS*.

*Somente Macs com Intel foram testadas

Com o CLI, é possível automatizar processamento de vídeo processing com scripts externos. Por exemplo, você poderia copiar e colar o código a seguir num arquivo .bat no Windows para baixar um VOD e seu chat, e depois renderizar o chat, tudo de um único valor.

@echo off
set /p vodid="Insira a ID da 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 - Instalação

  1. Vá para Releases e baixe a versão mais recente para Windows ou construa do código-fonte.
  2. Extraia o TwitchDownloaderCLI.exe.
  3. Navegue para onde você extraiu o executável:
cd C:\folder\containing\TwitchDownloaderCLI
  1. Se você não tem o FFmpeg, você pode instalar-lo via o gerenciador de pacotes Chocolatey, todavia também podes obter-lo como um arquivo separado no ffmpeg.org ou usando o TwitchDownloaderCLI:
TwitchDownloaderCLI.exe ffmpeg --download
  1. Você pode começar a usar o TwitchDownloaderCLI, por exemplo:
TwitchDownloaderCLI.exe videodownload --id <vod-id-here> -o out.mp4

Você pode encontrar mais comandos no CLI README.

Linux – Instalação

  1. Algumas distros, como o Alpine Linux, não têm fontes para algumas linguagens (Árabe, Persa, Tailandês, etc.) Se este for seu caso, instale fontes familiares adicionais como Noto ou leia a página da wiki de sua distro em fontes, tendo que deve haver um comando de instalação para essa situação específica, como a página de fontes do Alpine Linux .
  2. Verifique que ambos fontconfig e libfontconfig1 estão instalados. apt-get install fontconfig libfontconfig1 no Ubuntu.
  3. Vá para Releases e baixe o binário mais recente pro Linux, pegue o Pacote AUR pro Arch Linux, ou construa do código-fonte.
  4. Extraia o TwitchDownloaderCLI.
  5. Navegue para onde você extraiu o binário:
cd directory/containing/TwitchDownloaderCLI
  1. Dê ao binário direitos de execução:
sudo chmod +x TwitchDownloaderCLI
  1. a) Se você não tem o FFmpeg, você deve instalar-lo no sistema todo pelo gerenciador de pacotes da sua distro, todavia também podes obter-lo como um arquivo separado no ffmpeg.org ou usando o TwitchDownloaderCLI:
./TwitchDownloaderCLI ffmpeg --download
  1. b) Se baixado como um arquivo separado, também deve dar-lo direitos de execução com:
sudo chmod +x ffmpeg
  1. Você pode começar usando o TwitchDownloaderCLI, por exemplo:
./TwitchDownloaderCLI videodownload --id <vod-id-here> -o out.mp4

Você pode encontrar mais comandos no CLI README.

MacOS – Instalação

  1. Se seu dispositivo tem um processador série-M Apple Silicon, certifique-se que baixaste o binário do arm64, todavia se você prefere usar o binário em x64 no Apple Silicon deve ser rodado por uma sessão do terminal rodando dentro do Rosetta 2:
arch -x86_64 zsh
  1. Vá para Releases e baixe a versão mais recente para MacOS ou construa do código-fonte.
  2. Extraia o TwitchDownloaderCLI.
  3. Navegue para onde você extraiu o binário:
cd directory/containing/TwitchDownloaderCLI
  1. Dê ao binário direitos de execução:
chmod +x TwitchDownloaderCLI
  1. a) Se você não tem o FFmpeg, você deve instalar-lo no sistema todo pelo gerenciador de pacotes Homebrew, todavia também podes obter-lo como um arquivo separado no ffmpeg.org ou usando o TwitchDownloaderCLI:
./TwitchDownloaderCLI ffmpeg --download
  1. b) Se baixado como um arquivo separado, também deve dar-lo direitos de execução com:
chmod +x ffmpeg
  1. Você pode começar a usar o TwitchDownloaderCLI, por exemplo:
./TwitchDownloaderCLI videodownload --id <vod-id-here> -o out.mp4

Você pode encontrar mais comandos no CLI README.

Construíndo do código-fonte

Requerimentos

Instruções para construção

  1. Clone o repositório:
git clone https://github.com/lay295/TwitchDownloader.git
  1. Navegue até a pasta da solução:
cd TwitchDownloader
  1. Restaure a solução:
dotnet restore
  • Dispositivos que não usam Windows devem especificar explicitamente um projeto para restaurar, i.e. dotnet restore TwitchDownloaderCLI
  1. a) Construa o GUI:
dotnet publish TwitchDownloaderWPF -p:PublishProfile=Windows
  • Perfis Aplicáveis: Windows, Linux, LinuxAlpine, LinuxArm, LinuxArm64, MacOS, MacOSArm64
  1. a) Navegue para a pasta do GUI:
cd TwitchDownloaderWPF/bin/Release/net6.0-windows/publish/win-x64
  1. b) Navegue para a pasta do CLI:
cd TwitchDownloaderCLI/bin/Release/net6.0/publish

Créditos de terçeiros

Renderizações do Chat são renderizadas com SkiaSharp e HarfBuzzSharp © Microsoft Corporation.

Renderizações do Chat são codificados e Downloads do Vídeo são finalizados com FFmpeg © The FFmpeg developers.

Renderizações do Chat devem usar Noto Color Emoji © Google e contributors.

Renderizações do Chat devem usar Twemoji © Twitter e contributors.

Binários pré-instalados do FFmpeg são pegos do gyan.dev © Gyan Doshi.

Binários do FFmpeg pegos são runtime são baixados usando Xabe.FFmpeg.Downloader © Xabe.

Exportações do Chat em Html utilizam o typeface Inter hosteados pelo Google Fonts API © Google.

Para uma lista completa de bibliotecas externas, veja THIRD-PARTY-LICENSES.txt.

Licença

MIT

TwitchDownloader não é de modo algum associado com a Twitch Interactive, Inc. ou suas filiais.