YoutubePlus para NVDA

O YoutubePlus é um complemento para usuários do NVDA que adoram o YouTube, mas consideram muitos recursos do site difíceis de acessar — como ler comentários, acompanhar canais ou monitorar o chat ao vivo.

Trazemos esses recursos para a interface de usuário do NVDA em um formato de fácil navegação pelo teclado, com suporte a atalhos e totalmente personalizável — sem a necessidade de chaves de API ou login em contas do Google/YouTube.

Você pode acompanhar seus canais favoritos e ter a certeza de que verá todos os vídeos deles, sem que o algoritmo do YouTube os filtre. Um sistema de Favoritos está incluso para vídeos, canais, playlists, além de uma Lista de Assistir Mais Tarde para salvar conteúdos nos quais você tem interesse, mas ainda não teve tempo de assistir.

Há uma busca de vídeos integrada que exibe os resultados na própria interface do complemento — e não apenas uma caixa de pesquisa que abre o YouTube no navegador. Uma função de download está inclusa para salvar vídeos e áudios por conveniência — se o download for a sua necessidade principal, recomenda-se o uso de ferramentas dedicadas.

O que este complemento não faz é embutir um reprodutor de vídeo. Acreditamos que o reprodutor web do YouTube já é acessível o suficiente por si só. Se você ainda achar que ele deixa a desejar, pode utilizar outros complementos, como o browserNav, para melhorar a experiência.


Sumário


Atalhos de Teclado

Este complemento utiliza um sistema de Comando em Camadas para evitar conflitos com outros complementos ou comandos do NVDA.

Como usar:

  1. Pressione NVDA+Y para entrar no Modo de Comando do YoutubePlus (você ouvirá um som de notificação).
  2. Pressione a letra correspondente para ativar o recurso desejado.

Nota: Se o atalho NVDA+Y conflitar com outro complemento, você pode alterá-lo em NVDA → Preferências → Definir comandos... sob a categoria "YoutubePlus". Detecção de URL: Para comandos que exigem a URL de um vídeo, o complemento verifica primeiro a janela do navegador atualmente aberta. Se nenhuma URL do YouTube for encontrada ali, ele passa automaticamente a verificar a área de transferência.

Todas as teclas no modo YoutubePlus

| Tecla | Recurso | | ----- | --------- | | a | Menu "Adicionar para..." (Favoritos / Inscrever-se) | | f | Abrir Vídeos Favoritos | | c | Abrir Canais Favoritos | | p | Abrir Playlists Favoritas | | w | Abrir Lista de Assistir Mais Tarde | | b | Baixar legendas | | d | Baixar vídeo ou áudio | | e | Pesquisar no YouTube | | q | Pesquisa Rápida — pesquisa no YouTube imediatamente usando o texto selecionado ou o conteúdo da área de transferência, sem abrir o diálogo de pesquisa | | Control+H | Abre a janela de Favoritos diretamente na aba Histórico de Pesquisa | | i | Mostrar informações do vídeo | | t | Mostrar Capítulos / Marcadores de Tempo | | m | Gerenciar Inscrições | | s | Abrir Feed de Inscrições | | u | Gerenciar Perfis de Usuário | | l | Mostrar comentários ou iniciar monitoramento do chat ao vivo | | Shift+L | Parar monitoramento do chat ao vivo | | r | Alternar a leitura automática do chat ao vivo | | v | Reabrir a janela do chat ao vivo (enquanto a transmissão ainda estiver ativa) | | y | Abrir Configurações do YoutubePlus | | h | Abrir diálogo de Ajuda |


Detalhes dos Recursos

a: Menu Adicionar para...

Abre um submenu para escolher onde adicionar o vídeo ou canal atual:

A maioria dos comandos funciona com qualquer formato de URL do YouTube. Por exemplo, se você estiver na página de um vídeo e escolher "Adicionar aos Canais Favoritos", o complemento extrairá a URL do canal automaticamente.

Exceção: Para Playlists, você deve estar com a página de uma playlist do YouTube aberta ou ter uma URL de playlist válida na área de transferência.


d: Baixar Vídeo/Áudio

Pressione NVDA+Y → D para abrir um diálogo perguntando se deseja baixar como:

Um diálogo de progresso mostra a porcentagem do download enquanto ele é executado. O botão Cancelar está disponível a qualquer momento.

Defina a pasta de destino nas Configurações.

Nota: Este recurso é fornecido por conveniência. Para downloads em lote, recomendam-se ferramentas dedicadas.


b: Baixar Legendas

Pressione NVDA+Y → B para obter a lista de idiomas de legenda disponíveis para o vídeo atual e, em seguida, escolha em um diálogo. As legendas são listadas em dois tipos:

Formatos de arquivo suportados: SRT, VTT, TTML e TXT (texto simples sem marcadores de tempo). Configurável nas Configurações.


e: Pesquisar no YouTube

Pressione NVDA+Y → E para abrir a janela de pesquisa. Digite sua busca e pressione Enter para pesquisar imediatamente. Pressione Tab para ajustar o número de resultados (o complemento lembra desse valor para a próxima vez).

O campo de pesquisa é uma caixa de combinação que lembra suas pesquisas anteriores: pressione a seta para baixo (ou Alt+Seta para baixo) para exibir uma lista de palavras-chave anteriores e selecionar uma em vez de redigitá-la.

Os resultados são exibidos no mesmo formato de Lista de Vídeos usado em todo o complemento — e não como uma página da web do YouTube. Os resultados podem incluir vídeos, canais e playlists.

q: Pesquisa Rápida

Uma alternativa mais rápida ao diálogo de pesquisa. Selecione algum texto em qualquer aplicativo (ou tenha uma consulta copiada na área de transferência se nada estiver selecionado), depois pressione Q na camada do YoutubePlus. O complemento pesquisa no YouTube imediatamente usando esse texto e o número de resultados salvo da sua última pesquisa — sem diálogo, sem teclas extras.

Histórico de Pesquisa

Cada pesquisa que você realiza — pelo diálogo de pesquisa ou pela pesquisa rápida — é salva automaticamente. Pressione Control+H na camada do YoutubePlus para ir diretamente à aba Histórico de Pesquisa na janela de Favoritos, onde você pode:


i: Informações do Vídeo

Pressione NVDA+Y → I para visualizar os seguintes detalhes do vídeo atual:


t: Capítulos / Marcadores de Tempo

Pressione NVDA+Y → T para visualizar a lista de capítulos ou marcadores de tempo do vídeo atual (se o criador incluiu essas informações). Se o complemento informar "Nenhum capítulo encontrado", o vídeo simplesmente não possui dados de capítulos.

Esta janela inclui:


l: Comentários / Chat ao Vivo / Reprise do Chat ao Vivo

O YoutubePlus suporta três tipos de conteúdo através deste comando:

1. Comentários (para vídeos normais)

Pressione NVDA+Y → L enquanto estiver na página de um vídeo. O complemento obterá todos os comentários. Os comentários fixados aparecem primeiro, seguidos por todos os outros na ordem de classificação configurada nas Configurações.

A janela de Comentários inclui:

2. Chat ao Vivo (para transmissões ao vivo ativas)

Para vídeos que estão transmitindo ao vivo no momento, pressione L para abrir uma janela que recebe as mensagens do chat. Apenas as mensagens recebidas após a ativação deste comando são exibidas — o histórico anterior não é capturado.

Configurações relacionadas:

3. Reprise do Chat ao Vivo (para transmissões anteriores)

Para vídeos que já foram transmitidos ao vivo e onde o canal não removeu o chat, pressionar L exibirá um diálogo perguntando se deseja visualizar os Comentários ou a Reprise do Chat ao Vivo. A janela de reprise tem a mesma estrutura da janela de Comentários, com uma adição:


Favoritos (f, c, p, w)

A janela de Favoritos está dividida em 5 abas, cada uma acessível por comandos separados ou todas dentro da mesma janela.

| Tecla | Aba | | ----- | ----- | | F | Vídeos salvos (Vídeos Favoritos) — suporta categorias | | C | Canais salvos (Canais Favoritos) | | P | Playlists salvas (Playlists Favoritas) | | W | Vídeos para assistir mais tarde (Lista de Assistir Mais Tarde) — suporta categorias | | Control+H | Histórico de Pesquisa |

Atalhos na janela de Favoritos

Categorias (Abas Vídeos e Lista de Assistir Mais Tarde)

Ambas as abas permitem organizar itens em categorias usando uma exibição em árvore à esquerda, separada da lista de itens à direita. Cada aba mantém suas próprias categorias de forma independente. Sempre há um nó padrão para itens sem categoria ("Vídeos" na aba Vídeos, "Lista de Assistir Mais Tarde" na aba Lista).

Com o foco na árvore de categorias:

Com o foco na lista de itens (direita), clique direito ou pressione a tecla Aplicativo/Menu para o mesmo menu Ação usado em todo o complemento — separado do menu de contexto da árvore.

Recortar, Copiar e Colar na lista de itens sempre coloca os itens na categoria atualmente selecionada na árvore.

Aba Canais (Favoritos)

Esta aba oferece mais do que uma simples lista — ela também inclui:

Aba Playlists (Favoritos)

s: Feed de Inscrições

Uma janela que exibe vídeos dos canais que você acompanha através do complemento. Isso é independente das inscrições da sua conta do YouTube — não é necessário fazer login.

A visualização padrão possui 4 abas por tipo de conteúdo:

| Aba | Conteúdo | | ----- | --------- | | Tudo | Todos os tipos de conteúdo combinados | | Vídeo | Apenas vídeos normais | | Shorts | Apenas vídeos de formato curto (Shorts) | | Ao Vivo | Transmissões ao vivo e reprises de lives |

Você também pode criar categorias personalizadas e configurar quais canais aparecem em cada uma delas.

Atalhos no Feed de Inscrições

Botões na janela do Feed de Inscrições


m: Gerenciar Inscrições

Uma janela que mostra todos os canais nos quais você está inscrito, com opções de gerenciamento para cada um:


u: Gerenciador de Perfis de Usuário

O complemento suporta múltiplos Perfis de Usuário na mesma máquina. Cada perfil mantém seus dados completamente separados (Favoritos, Inscrições, Lista de Assistir Mais Tarde).

Nesta janela:

Para alternar de perfil, vá em Configurações → Perfil Ativo e, em seguida, reinicie o NVDA.


Lista de Vídeos

A lista de vídeos é a interface padrão usada em todo o complemento — nos resultados de pesquisa, Favoritos, Feed de Inscrições e na navegação de vídeos de canais.

Botão Ação (Alt+A)

Abre o menu de Ações para o vídeo selecionado:

| Item do menu | Atalho | | ----------- | --------- | | Ver Informações do Vídeo | i | | Ver Comentários / Reprise | c | | Ver Capítulos/Marcadores de Tempo | t | | Baixar Vídeo | d | | Baixar Áudio | a | | Baixar Legendas | b | | Adicionar aos Vídeos Favoritos | f | | Adicionar aos Canais Favoritos | f | | Adicionar à Lista de Assistir Mais Tarde | w | | Abrir vídeo no navegador | o | | Abrir canal no navegador | h | | Mostrar vídeos do canal | v | | Mostrar shorts do canal | s | | Mostrar lives do canal | l |

Botão Copiar (Alt+C)

Abre o menu de Cópia:

| Item do menu | Atalho | | ----------- | --------- | | Copiar Título | t | | Copiar URL do Vídeo | u | | Copiar Nome do Canal | c | | Copiar URL do Canal | h | | Copiar Resumo | s |


Configurações

Acesse através de NVDA → Preferências → Configurações... e selecione a categoria "YoutubePlus".

| Configuração | Descrição | | --------- | ------------- | | Perfil Ativo | Seleciona o perfil ativo (requer a reinicialização do NVDA após a alteração) | | Gerenciar Perfis | Abre o Gerenciador de Perfis de Usuário | | Ação Rápida (Barra de espaço) | Define o que a tecla Espaço faz nas janelas de lista de vídeos; todas as opções do menu de Ação estão disponíveis | | Modo de notificação | Como o complemento sinaliza atividades em segundo plano: Bip (tons curtos), Som (arquivo de áudio), Silencioso (sem áudio, mensagens faladas ainda ocorrem) | | Ordem de classificação padrão | Ordem de exibição padrão: Mais recentes primeiro ou Mais antigos primeiro — aplica-se a comentários, chat e listas de vídeos de canais | | Itens a obter | Número de itens recuperados por tipo de conteúdo ao navegar em um canal ou atualizar o feed (padrão: 20, intervalo: 5–100) | | Tipos de conteúdo padrão | Tipos de conteúdo a obter para canais recém-inscritos: Vídeos, Shorts, Ao Vivo | | Intervalo de atualização em segundo plano | Com que frequência o complemento verifica automaticamente se há novos conteúdos nos canais inscritos (desativado, ou de 15 minutos a 24 horas) | | Falar chat ao vivo recebido automaticamente | Lê novas mensagens do chat ao vivo em voz alta à medida que chegam | | Intervalo de atualização do chat ao vivo | Com que frequência (em segundos) o complemento verifica se há novas mensagens (padrão: 5 segundos) | | Limite do histórico de mensagens | Número máximo de mensagens de chat armazenadas na memória durante uma sessão (padrão: 5.000) | | Método de Cookies (Experimental) | Selecione o navegador no qual você está logado no YouTube. O complemento extrairá os cookies desse navegador para autenticar as requisições, o que pode ajudar a resolver o erro "Faça login para confirmar que você não é um robô". Note que este recurso é experimental e os resultados variam dependendo do navegador e da configuração do sistema. | | Formato de legenda padrão | Formato de arquivo de legenda para downloads: SRT, VTT, TTML ou TXT (texto simples sem marcadores de tempo) | | Caminho padrão da pasta de download e exportação | Pasta de destino para vídeos baixados, áudios e arquivos exportados | | Fazer backup dos dados agora | Faz o backup imediato de todos os dados do perfil ativo (o complemento também realiza um backup automático diário) | | Restaurar dados a partir do backup | Mostra os backups disponíveis (até os últimos 5 dias) para escolher para a restauração |


Informações Adicionais

Este complemento conta com duas bibliotecas principais: pytchat para o monitoramento do chat ao vivo, e yt-dlp para todos os outros acessos a dados do YouTube. Expressamos nossos sinceros agradecimentos aos desenvolvedores de ambas as bibliotecas.

Sobre o yt-dlp

O yt-dlp é uma das ferramentas de código aberto mais poderosas para baixar vídeos e áudios de sites em todo o mundo — suportando mais de 1.000 sites, não apenas o YouTube. Ele é gratuito, de código aberto, mantido ativamente por uma comunidade global e não contém anúncios ou malwares, ao contrário de muitas ferramentas de download baseadas no navegador.

Diretrizes de uso para ter em mente:

  1. Uso Justo: Evite obter grandes quantidades de dados ou enviar requisições repetidas em um curto espaço de tempo. O YouTube pode detectar atividade incomum e restringir temporariamente o acesso do seu endereço IP.
  2. Direitos Autorais e Privacidade: Quaisquer dados ou conteúdos recuperados devem ser apenas para visualização ou análise pessoal. Por favor, respeite os Termos de Serviço de cada plataforma e não utilize os dados de maneiras que infrinjam os direitos autorais.
  3. Responsabilidade: Você é responsável por como utiliza este software. O desenvolvedor do complemento fornece apenas a interface para acessar os dados do YouTube através da biblioteca yt-dlp.

Dica: Se você precisar processar grandes quantidades de dados, espaçe suas requisições para manter a estabilidade da conexão e evitar restrições de acesso.