SageTube/readme-translations/README.pt.md

Um downloader de YouTube moderno com uma interface PySide6 limpa.
Baixe vídeos em qualquer qualidade, extraia áudio, obtenha legendas e muito mais.

🌍 Idiomas do README

Inglês: EN | Árabe: AR | Alemão: DE | Espanhol: ES | Francês: FR | Hindi: HI | Indonésio: ID | Italiano: IT | Japonês: JA | Polonês: PL | Português: PT | Russo: RU | Turco: TR | Chinês: ZH

Instalação • Funcionalidades • Uso • Capturas de Tela • Solução de Problemas • Patrocinar • Contribuindo

---

❓ Por que YTSage?

O YTSage foi projetado para usuários que desejam um downloader de YouTube simples, mas poderoso. Ao contrário de outras ferramentas, ele oferece:

• Uma interface PySide6 moderna e limpa
• Download de vídeo, áudio e legendas com um clique
• Recursos avançados como SponsorBlock, mesclagem de legendas e seleção de playlist
• Modo Genérico opcional para sites além do YouTube suportados pelo yt-dlp
• Suporte multiplataforma e instalação fácil

✨ Funcionalidades

Recursos Básicos	Recursos Avançados	Recursos Extras
🎥 Tabela de Formatos	🚫 Integração SponsorBlock	🎞️ Exibição de FPS/HDR
🎵 Extração de Áudio	📝 Seleção e Mesclagem de Legendas	🔄 Atualização Automática do yt-dlp
✨ Interface de Usuário Simples	💾 Salvar Descrição e Miniatura	🛠️ Detecção de FFmpeg/yt-dlp/Deno
📋 Suporte e Seletor de Playlist	🚀 Limitador de Velocidade	⚙️ Comandos Personalizados
📑 Integração de Capítulos	✂️ Cortar Seções de Vídeo	🍪 Login por Cookies
📜 Histórico de Downloads	🔄 Escolha do Canal de Lançamento	🌐 Suporte a Proxy
🎚️ Conversão de Formato de Áudio	🎬 Configurações de Formato de Vídeo	🆙 Aba de Atualização Integrada
🌍 Modo Genérico	🔊 Normalização de Áudio (EBU R128)	🌍 Localização em 14 idiomas
💾 Exportação de Playlist	⚙️ Qualidade e Legendas Padrão

🚀 Instalação

⚡ Instalação Rápida (Recomendada)

Instale o YTSage via PyPI:

pip install ytsage

🔄 Atualizar Instalação Existente

pip install --upgrade ytsage

Em seguida, execute o aplicativo:

ytsage

📦 Executáveis Pré-compilados (Executable)

👉 Baixar Lançamento Mais Recente

🪟 Windows

Formato	Descrição
	Instalador Padrão
	Com FFmpeg incluído
	Versão Portátil, sem necessidade de instalação
	Portátil com FFmpeg, compactado (ZIP)

🛠️ Passos para Instalação

1. Instalador EXE (.exe): Clique duas vezes no arquivo e siga o assistente de configuração.
2. Versão Portátil (.zip): Extraia o arquivo para o local desejado e execute ytsage.exe.
3. FFmpeg Integrado: Se você não possui o FFmpeg instalado no sistema, escolha as versões com FFmpeg integrado.

🐧 Linux

Formato	Descrição
	Pacote Debian
	AppImage, Portátil
	Pacote RPM
	Pacote Flatpak

🛠️ Passos para Instalação

• DEB (.deb):

  sudo dpkg -i ytsage_*.deb
  sudo apt-get install -f # Se necessário para corrigir dependências ausentes
  

• RPM (.rpm):

  sudo rpm -i ytsage-*.rpm
  

• AppImage (.AppImage):

  chmod +x YTSage-*.AppImage
  ./YTSage-*.AppImage
  

• Flatpak: Siga as instruções no Flathub ou execute:

  flatpak install flathub io.github.oop7.ytsage
  

🍎 macOS

Formato	Descrição
	Aplicativo ZIP para Apple Silicon
	Instalador Disk Image para Apple Silicon

🛠️ Passos para Instalação

• Instalador DMG (.dmg): Clique duas vezes para montar e arraste YTSage.app para a sua pasta Aplicativos.
• Arquivo do Aplicativo (.zip): Extraia o ZIP e mova YTSage.app para a sua pasta Aplicativos.

Nota: Se você receber o erro "App está danificado", veja a seção de Problemos no macOS abaixo.

---

💻 Instalação Manual a partir do Código-Fonte

1. Clonar o Repositório

git clone https://github.com/oop7/YTSage.git
cd YTSage

2. Instalar Dependências

⚡ Com uv

uv pip install .

📦 Ou com pip padrão

pip install .

3. Executar o Aplicativo

python -m ytsage.main

📸 Capturas de Tela

Configurações de Download	Download de Playlist
Formato de Áudio	Opções Personalizadas

📖 Uso

🎯 Uso Básico

1. Inicie o YTSage
2. Cole uma URL do YouTube (ou use o botão "Paste URL")
3. Clique em "Analyze"
4. Escolha o Formato:
   • Video para download de vídeo
   • Audio Only para extração de áudio
5. Selecione Opções:
   • Habilite legendas e escolha o idioma
   • Habilite a mesclagem de legendas
   • Salvar miniatura
   • Remover seções de patrocinadores
   • Salvar descrição
   • Incorporar capítulos
6. Escolha o Diretório de Saída
7. Clique em "Download"

💡 O diretório de download padrão é a pasta "Downloads" do usuário.

📋 Download de Playlist

1. Cole a URL da Playlist
2. Clique em "Analyze"
3. Selecione vídeos do seletor (opcional, padrão todos)
4. Escolha o formato/qualidade desejado
5. Clique em "Download"

💡 O aplicativo gerencia automaticamente a fila de download, e você pode exportar as entradas da playlist como arquivos .txt, .csv, .m3u ou .json.

🌍 Modo Genérico para Sites além do YouTube

Use o Modo Genérico quando quiser que o YTSage aceite URLs de sites suportados pelo yt-dlp, como Dailymotion, CBC Gem, TikTok e outros.

Como usar:

1. Abra Download Settings.
2. Habilite Generic Mode.
3. Cole uma URL de vídeo ou playlist suportada que não seja do YouTube.
4. Clique em Analyze.
5. Escolha um formato e baixe normalmente.

Notas:

• O Modo Genérico apenas altera a validação da URL dentro do YTSage. O site de destino ainda deve ser suportado pela sua versão instalada do yt-dlp.
• Alguns sites exigem cookies, login, proxy ou argumentos adicionais do yt-dlp, dependendo do extrator.
• Se um site falhar, atualize o yt-dlp na aba de atualização integrada antes de relatar o problema.

🧰 Opções de Mídia e Download

• Opções de Legendas: Filtre idiomas e incorpore legendas no arquivo de vídeo.
• Mesclagem de Legendas: Mescla legendas no arquivo de vídeo para legendas fixas (hardcoded).
• Salvar Descrição: Salva a descrição do vídeo como um arquivo de texto.
• Salvar Miniatura: Salva a miniatura do vídeo como um arquivo de imagem.
• Incorporar Capítulos: Inclui marcadores de capítulo como metadados para players de vídeo compatíveis.
• Remover Seções de Patrocinadores: Usa o SponsorBlock para remover segmentos patrocinados do vídeo.
• Cortar Vídeo: Baixe apenas partes específicas do vídeo, especificando o intervalo de tempo no formato HH:MM:SS.

⚙️ Configurações de Saída e Arquivos

• Limitador de Velocidade: Limite a velocidade de download, por exemplo, 500K para 500 KB/s.
• Salvar Caminho de Download: Salva o caminho de download padrão para downloads futuros. Disponível em Download Settings → Download Path.
• Resolução de Vídeo Padrão: Defina sua resolução de vídeo preferida para seleção automática (ex: 1080p, 720p). Disponível em Download Settings → Default Video Resolution.
• Idiomas de Legendas Padrão: Defina idiomas de legendas padrão para seleção automática (separados por vírgula, ex: pt,en). Disponível em Download Settings → Default Subtitle Languages.
• Formato de Nome de Arquivo: Personalize o formato do nome do arquivo de saída usando variáveis como %(title)s, %(uploader)s, %(playlist_index)s e %(resolution)s. Disponível em Download Settings → Filename Format.
• Forçar Formato de Saída: Força o download do vídeo em um formato de contêiner específico, como mp4, webm ou mkv. Disponível em Download Settings → Output Format Settings.
• Conversão de Formato de Áudio: Converta downloads de apenas áudio para formatos preferidos como AAC, MP3, FLAC, WAV, Opus, M4A, Vorbis, ou Best. Disponível em Download Settings → Audio Format Settings.
• Normalização de Áudio: Padroniza o volume para downloads de apenas áudio usando EBU R128.
• Conexões Simultâneas: Aumente significativamente a velocidade de download baixando arquivos em várias partes ao mesmo tempo. Disponível em Download Settings → General → Concurrent Connections (padrão 1, máximo 8-10 recomendado para evitar bloqueios de IP).

🌐 Acesso e Rede

• Login por Cookies: Faça login no YouTube usando cookies para acessar conteúdo privado. Uso:
  1. Recomendado: Use a opção integrada Extract cookies from browser no aplicativo, selecione o navegador e, opcionalmente, o perfil.
  2. Opcionalmente, extraia cookies manualmente: a. Exporte cookies do seu navegador usando uma extensão como cookie-editor b. Copie os cookies no formato Netscape c. Crie um arquivo chamado cookies.txt e cole os cookies d. Selecione o arquivo cookies.txt no aplicativo
• Suporte a Proxy: Use um servidor proxy para downloads, ex: http://<proxy-server>:<port>
• Modo Genérico: Permite que o YTSage analise e baixe de sites além do YouTube suportados pelo yt-dlp. Habilite em Download Settings → Generic Mode.

🛠️ Ferramentas e Manutenção

• Comandos Personalizados: Acesse recursos avançados do yt-dlp via argumentos de linha de comando.
• Aba de Atualização: Gerencie as ferramentas de atualização integradas em um só lugar nas Opções Personalizadas:
  • Atualização do yt-dlp: Verifique atualizações e alterne entre os canais de lançamento Stable e Nightly.
  • Verificador de Versão do FFmpeg: Verifique sua versão do FFmpeg e abra guias de instalação.
  • Atualização do Deno: Verifique e atualize o runtime do Deno.
• Detecção de FFmpeg/yt-dlp/Deno: Detecta automaticamente caminhos e versões de FFmpeg, yt-dlp e Deno no diálogo Sobre.
• Histórico de Downloads: Veja downloads anteriores com miniaturas e status no botão History.

🌍 Localização

O YTSage suporta 14 idiomas para alcance global. Escolha o seu idioma preferido em Custom Options → Language.

Idiomas Suportados

Idioma	Código	Idioma	Código
🇺🇸 Inglês	en	🇪🇸 Espanhol	es
🇸🇦 Árabe	ar	🇫🇷 Francês	fr
🇩🇪 Alemão	de	🇮🇳 Hindi	hi
🇮🇩 Indonésio	id	🇮🇹 Italiano	it
🇯🇵 Japonês	ja	🇵🇱 Polonês	pl
🇧🇷 Português	pt	🇷🇺 Russo	ru
🇹🇷 Turco	tr	🇨🇳 Chinês	zh

Traduções do README

Idioma	Arquivo	Idioma	Arquivo
🇺🇸 Inglês	README.md	🇪🇸 Espanhol	README.es.md
🇸🇦 Árabe	README.ar.md	🇫🇷 Francês	README.fr.md
🇩🇪 Alemão	README.de.md	🇮🇳 Hindi	README.hi.md
🇮🇩 Indonésio	README.id.md	🇮🇹 Italiano	README.it.md
🇯🇵 Japonês	README.ja.md	🇵🇱 Polonês	README.pl.md
🇧🇷 Português	README.pt.md	🇷🇺 Russo	README.ru.md
🇹🇷 Turco	README.tr.md	🇨🇳 Chinês	README.zh.md

💡 Quer ajudar na tradução? Veja a seção Contribuindo para nos ajudar a adicionar mais idiomas!

🛠️ Solução de Problemas

Clique para ver problemas comuns e soluções

• Tabela de formatos não aparece: Atualize o yt-dlp para a versão mais recente e tente alternar para o yt-dlp Nightly.
• Download falhou: Verifique sua conexão com a internet e certifique-se de que o vídeo está disponível.
• Erros de Download Específicos:
  • Vídeos Privados: Use a autenticação por cookies para acessar conteúdo privado.
  • Conteúdo com Restrição de Idade: Faça login na sua conta do YouTube para visualizar vídeos com restrição de idade.
  • Vídeos com Bloqueio Geográfico: Considere usar uma VPN para contornar restrições regionais.
  • Vídeo Removido: O vídeo não está mais disponível no YouTube.
  • Live Streams: Transmissões ao vivo não podem ser baixadas enquanto estão sendo transmitidas; aguarde até que a transmissão termine.
  • Erros de Rede: Verifique sua conexão com a internet e tente novamente.
  • URL Inválida: Certifique-se de que a URL está correta e pertence a uma plataforma suportada.
  • Conteúdo Premium: Requer uma assinatura do YouTube Premium.
  • Bloqueio por Direitos Autorais: O conteúdo está bloqueado devido a restrições de direitos autorais.
• Arquivos de vídeo e áudio estão separados após o download: Isso acontece quando o FFmpeg está ausente ou não foi detectado. O YTSage requer o FFmpeg para mesclar streams de vídeo e áudio de alta qualidade.
  • Solução: Certifique-se de que o FFmpeg está instalado e acessível no PATH do seu sistema. Para usuários do Windows, a opção mais fácil é baixar o arquivo YTSage-v<versão>-ffmpeg.exe, que já vem com o FFmpeg.

---

🛡️ Aviso do Windows Defender / Antivírus

Alguns softwares antivírus podem sinalizar arquivos .exe como falsos positivos. Esta é uma limitação conhecida de aplicativos empacotados.

Por que isso acontece:

• As heurísticas do antivírus podem identificar incorretamente executáveis empacotados como suspeitos.

Opções Seguras:

• ✅ Use a instalação via pip: pip install ytsage (recomendado)
• ✅ Compile a partir do código-fonte: Seguindo este guia
• ✅ Adicione o aplicativo à lista de permissões do seu software antivírus.

🍎 macOS: "App está danificado e não pode ser aberto"

Se você vir este erro no macOS Sonoma ou mais recente, você precisa remover o atributo de quarentena.

1. Abra o Terminal (você pode encontrá-lo usando o Spotlight).
2. Digite o seguinte comando, mas ainda NÃO pressione Enter. Certifique-se de incluir o espaço no final:

   xattr -d com.apple.quarantine 
   

3. Arraste o arquivo YTSage.app da janela do Finder e solte-o diretamente na janela do Terminal. Isso colará automaticamente o caminho correto do arquivo.
4. Pressione Enter para executar o comando.
5. Tente abrir o YTSage.app novamente. Ele agora deve iniciar corretamente.

---

Localização da Configuração (Avançado)

• Windows: %LOCALAPPDATA%\YTSage
• macOS: ~/Library/Application Support/YTSage
• Linux: ~/.local/share/YTSage

💖 Patrocinar

Se o YTSage economiza seu tempo, considere patrocinar o projeto. Os patrocínios ajudam a cobrir o tempo de desenvolvimento, testes em todas as plataformas e melhorias futuras.

• GitHub Sponsors: https://github.com/sponsors/oop7
• O link de patrocínio está disponível diretamente através do diálogo Sobre no aplicativo.

👥 Contribuindo

Contribuições são bem-vindas! Veja como você pode ajudar:

1. 🍴 Faça um Fork do repositório
2. 🌿 Crie sua branch de recurso:

git checkout -b feature/RecursoIncrivel

3. 💾 Faça o commit de suas alterações:

git commit -m 'Adicionar RecursoIncrivel'

4. 📤 Faça o push para a branch:

git push origin feature/RecursoIncrivel

5. 🔄 Abra um Pull Request

🌍 Contribua com Traduções

• Atualize o arquivo README localizado relevante (ex: readme-translations/README.pt.md)
• Mantenha as strings do aplicativo em sincronia editando ytsage/languages/<code>.json
• Se o seu idioma estiver ausente, comece pelo README.md e crie README.<code>.md

📂 Estrutura do Projeto

YTSage - Estrutura do Projeto

Este documento descreve a estrutura de pastas organizada do YTSage.

📁 Estrutura do Projeto

YTSage/
├── 📁 .github/                   # Configurações do GitHub
│   ├── 📁 ISSUE_TEMPLATE/         # Modelos de problemas
│   │   └── 🐛-bug-report.md       # Modelo de relatório de erro
│   ├─── 📁 workflows/              # Fluxos de trabalho do GitHub Actions
│   │   ├── build-linux.yml        # Fluxo de build para Linux
│   │   ├── build-macos.yml        # Fluxo de build para macOS
│   │   │── build-windows.yml      # Fluxo de build para Windows
|   |   └── release-all.yml          # Fluxo de lançamento principal
│   └── 📄 CI_CD_README.md        # Documentação CI/CD
├──  📁 branding/                 # Ativos de marca (capturas de tela, SVGs)
│   ├── 📁 icons/                 # Ícones do aplicativo
│   ├── 📁 screenshots/           # Capturas de tela para documentação
│   └── 📁 svg/                   # Ativos SVG
├── 📄 LICENSE                    # Arquivo de licença
├── 📄 pyproject.toml             # Metadados do projeto e dependências
├── 📄 README.md                  # Documentação do projeto
├── 📄 requirements.txt           # Dependências Python (dev)
└── 📁 ytsage/                    # Pacote de código-fonte
    ├── 📁 assets/                # Ativos de tempo de execução
    │   ├── 📁 Icon/              # Ícones do aplicativo
    │   └── 📁 sound/             # Arquivos de áudio
    ├── 📁 languages/             # Arquivos de localização
    │   ├── 📄 ar.json            # Tradução em árabe
    │   ├── 📄 de.json            # Tradução em alemão
    │   ├── 📄 en.json            # Tradução em inglês
    │   └── ...                   # Outros idiomas
    ├── 📁 core/                  # Lógica de negócios principal
    │   ├── 📄 __init__.py        
    │   ├── 📄 ytsage_deno.py     # Integração Deno
    │   ├── 📄 ytsage_downloader.py # Funcionalidade de download
    │   ├── 📄 ytsage_ffmpeg.py   # Integração FFmpeg
    │   ├── 📄 ytsage_utils.py    # Funções utilitárias
    │   └── 📄 ytsage_yt_dlp.py   # Integração yt-dlp
    ├── 📁 gui/                   # Componentes de interface do usuário
    │   ├── 📄 __init__.py        
    │   ├── 📄 ytsage_gui_main.py # Janela principal do aplicativo
    │   └── 📁 ytsage_gui_dialogs/ # Classes de diálogo
    ├── 📁 utils/                 # Módulos utilitários
    │   ├── 📄 __init__.py        
    │   ├── 📄 ytsage_config_manager.py # Gerenciamento de configuração
    │   └── 📄 ytsage_logger.py   # Ferramentas de registro
    ├── 📄 __init__.py            # Ponto de entrada do pacote
    └── 📄 main.py                # Script de execução principal

⭐️ Histórico de Estrelas

Star History

📜 Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para mais detalhes.

🙏 Agradecimentos

Mostrar Agradecimentos

Muito obrigado a todos que contribuíram para este projeto abrindo problemas para sugerir melhorias ou relatar erros.

Componentes Principais
yt-dlp	Mecanismo de Download
FFmpeg	Processamento de Mídia
Deno	Runtime para integração do yt-dlp
Bibliotecas e Frameworks
PySide6	Framework GUI
Pillow	Processamento de Imagens
requests	Requisições HTTP
packaging	Gerenciamento de Versão e Empacotamento
markdown	Renderização de Markdown
loguru	Registro de Logs
Ativos e Contribuidores
New Notification 09 de Universfield	Som de Notificação
viru185	Contribuidor de Código

⚠️ Isenção de Responsabilidade

Esta ferramenta é apenas para uso pessoal. Respeite os Termos de Serviço do YouTube e os direitos dos produtores de conteúdo.

---

Criado com ❤️ por oop7