OPTDOWNS v2.13.0 YouTube Integration & Improvements

OPTDOWNS v2.13.0 YouTube Support & Improvements

A versão 2.13.0 chegou com uma das maiores novidades do OPTDOWNS: o suporte ao YouTube, incluindo vídeos tradicionais e Shorts.

Agora o script conta com uma nova interface de download por link, mostrando a miniatura, o título e as opções de qualidade disponíveis. Também foi adicionado suporte a MP4, WebM e MP3, dependendo dos formatos oferecidos pela fonte.

O sistema de download recebeu melhorias no tratamento dos arquivos, seleção de formatos e acompanhamento do progresso. A integração com o Cloudflare Worker foi ampliada para trabalhar com o Cobalt, permitindo que cada instalação configure sua própria instância.

Também aproveitei esta atualização para organizar melhor o projeto. Os READMEs em português e inglês foram atualizados, a documentação do Worker foi revisada e foram adicionados novos guias sobre a integração com o YouTube.

As funcionalidades anteriores continuam preservadas, incluindo os downloads do TikTok, Instagram e outras plataformas já suportadas.

Sobre o YouTube: a integração já está implementada, mas precisa de uma instância Cobalt configurada para funcionar. Os testes automatizados passaram, porém a conexão com o YouTube real ainda precisa ser validada.

Obrigado a todos que acompanham e apoiam o desenvolvimento do OPTDOWNS. ❤️

Full changelog: confira os arquivos README e a pasta docs/ para mais detalhes.

OPTDOWNS 2.11.0

OPTDOWNS 2.11.0 Detecção, processamento e download de vídeos diretamente pelo navegador

O OPTDOWNS 2.11.0 é um userscript desenvolvido para identificar conteúdos de vídeo disponíveis nas páginas visitadas e reunir as opções de mídia em uma interface própria, facilitando a seleção e o download de arquivos compatíveis. O projeto foi pensado principalmente para dispositivos móveis, com uma interface adaptada ao toque e atenção especial ao comportamento do Safari no iOS, mantendo também sua utilização em navegadores de desktop.

A proposta é tornar o processo de localizar, selecionar e salvar mídias mais organizado, oferecendo ferramentas de detecção automática, processamento de playlists HLS, seleção de qualidade, downloads por link e diagnóstico de problemas tudo em uma única interface.

✨ Principais funcionalidades

🔎 Detecção automática de vídeos

O OPTDOWNS monitora diferentes fontes de informação disponíveis na página para localizar possíveis conteúdos de mídia. Para isso, utiliza elementos de vídeo, requisições de rede, informações de desempenho do navegador, alterações no conteúdo da página e metadados.

Os conteúdos identificados são organizados em cartões que podem apresentar informações como miniatura, duração e resolução, permitindo visualizar as opções encontradas e escolher qual mídia deseja processar.

Quando necessário, iniciar a reprodução do vídeo pode ajudar a página a disponibilizar os endereços de mídia que o script precisa identificar.

🎞️ Conversão de playlists HLS para MP4

O script oferece suporte a playlists HLS, incluindo playlists principais e playlists de mídia. Quando o formato e os codecs são compatíveis, o usuário pode selecionar a qualidade do vídeo e a faixa de áudio disponível antes de iniciar o download.

O processo reúne os segmentos da transmissão e utiliza o mux.js para multiplexar a mídia em um único arquivo MP4. O processamento ocorre no próprio navegador, por meio de um Web Worker, evitando depender de um servidor externo para realizar essa conversão.

O sistema também oferece suporte limitado a transmissões HLS com criptografia AES-128 e chave pública acessível. Esse suporte não inclui a remoção de DRM nem a superação de mecanismos de controle de acesso.

📥 Download de arquivos de vídeo diretos

O OPTDOWNS reconhece links diretos para arquivos nos formatos:

• MP4
• WebM
• MOV

Para arquivos compatíveis, o script pode dividir as requisições em blocos, utilizar tentativas adicionais em caso de falha e acompanhar o andamento do download. Essa abordagem ajuda a lidar com arquivos grandes sem depender exclusivamente de uma única requisição prolongada.

Antes de salvar o resultado, o script verifica o arquivo para reduzir o risco de salvar uma página HTML de erro como se fosse um vídeo MP4. Após o processamento, também pode apresentar um resumo com informações sobre codecs e resolução.

🔗 Busca de mídia por link

Além da detecção automática, o usuário pode inserir manualmente um endereço para procurar conteúdos disponíveis. O campo aceita diferentes tipos de origem, incluindo:

• Links diretos para arquivos de vídeo.
• Playlists HLS, como arquivos .m3u8.
• Publicações públicas compatíveis do TikTok.
• Publicações públicas compatíveis do Instagram.
• Páginas que contêm vários vídeos.

A interface separa os resultados relacionados a “Este vídeo” daqueles encontrados em “Vídeos da página”, facilitando a navegação quando uma página possui vários conteúdos de mídia.

O script também mantém uma área de fontes compatíveis e pode apresentar links recentes para tornar o acesso às buscas anteriores mais prático.

🎚️ Seleção de qualidade e opções de mídia

Quando uma mesma mídia possui diferentes variantes, o OPTDOWNS agrupa as opções correspondentes e permite escolher a qualidade antes do download.

Nas playlists HLS compatíveis, também é possível selecionar uma faixa de áudio disponível. As opções efetivamente apresentadas dependem das informações publicadas pela fonte e das características do conteúdo.

📱 Interface adaptada para dispositivos móveis

A interface foi desenvolvida com foco em telas menores, controles sensíveis ao toque e navegação simplificada. Um botão flutuante permite abrir o painel durante a navegação, reunindo as funções de detecção, busca por link, seleção de mídia e diagnóstico.

O projeto considera particularidades do Safari no iOS, incluindo situações em que o navegador exige uma interação adicional para salvar um arquivo ou disponibiliza o compartilhamento como alternativa.

Em navegadores de desktop, o painel mantém o mesmo conjunto principal de funcionalidades, adaptando-se ao ambiente de uso.

🧰 Diagnóstico e identificação de problemas

O OPTDOWNS inclui uma área de diagnóstico destinada a verificar o ambiente de execução e ajudar a identificar falhas que podem afetar a detecção ou o download.

Entre as verificações estão a disponibilidade das funções do gerenciador de userscripts, o carregamento do mux.js e, quando configurado, a comunicação com o Cloudflare Worker.

A ferramenta também registra erros recentes, apresenta possíveis causas e sugere procedimentos para investigar problemas comuns, como URLs expiradas, respostas HTTP inesperadas, limitações de acesso entre domínios e falhas de configuração.

O usuário pode copiar um relatório de diagnóstico para anexá-lo a uma solicitação de suporte ou a uma issue do projeto. Tokens, cookies e parâmetros de consulta são mascarados no relatório preparado para compartilhamento.

☁️ Integração opcional com Cloudflare Workers

O funcionamento principal do OPTDOWNS ocorre no navegador, sem exigir um servidor próprio. Entretanto, determinados sites e redes de distribuição de conteúdo podem impedir requisições diretas feitas pelo navegador.

Para esses casos, o projeto permite configurar um Cloudflare Worker próprio como alternativa complementar. Essa integração pode ajudar na resolução de determinados links, especialmente quando a origem restringe o acesso direto à mídia.

O Worker é opcional e não é fornecido como serviço hospedado pelo projeto. Para utilizá-lo, é necessário implantar uma instância própria e configurar o endereço correspondente no script. A utilização de um Worker não garante compatibilidade com todas as fontes.

🖼️ Miniaturas e identificação das fontes

Quando as informações estão disponíveis, os cartões de mídia exibem miniaturas e dados do conteúdo para facilitar sua identificação. O script também utiliza serviços públicos de favicon para apresentar logotipos dos sites de origem e mantém um cache local desses recursos.

As miniaturas são solicitadas considerando as condições esperadas pelo site de origem, embora sua disponibilidade dependa das regras e dos recursos publicados por cada plataforma.

⚙️ Como o processamento funciona

O fluxo de funcionamento do OPTDOWNS é organizado em etapas:

1. Detecção: identifica possíveis mídias por meio dos elementos da página, das requisições de rede e dos metadados disponíveis.
2. Resolução: interpreta as fontes compatíveis e identifica opções como arquivos diretos, playlists, qualidades e faixas de áudio.
3. Download: realiza as requisições utilizando as funções disponibilizadas pelo gerenciador de userscripts, com tratamento de falhas e novas tentativas quando aplicável.
4. Processamento: reúne os segmentos HLS compatíveis e utiliza o mux.js para gerar o arquivo MP4 no navegador.
5. Validação e salvamento: verifica o resultado e encaminha o arquivo para o mecanismo de download disponível no navegador.

O projeto utiliza JavaScript, HTML e CSS, a API de userscripts para operações de rede e download, o mux.js para o processamento de mídia e a Web Crypto API para o suporte limitado a HLS com AES-128.

🔐 Privacidade e comportamento de rede

O OPTDOWNS não possui sistema próprio de contas, analytics ou telemetria. As requisições necessárias para localizar e baixar mídias são realizadas diretamente pelo navegador e pelo gerenciador de userscripts, de acordo com a origem do conteúdo e as permissões concedidas.

O mux.js é carregado da distribuição pública do unpkg. Os logotipos dos sites podem ser consultados em serviços públicos de favicon, e alguns dados funcionais — como links recentes, cache de logotipos e um indicador de primeira execução — são mantidos localmente.

Se o usuário configurar um Cloudflare Worker, o endereço solicitado e as requisições de verificação correspondentes serão enviados a essa instância. Por isso, recomenda-se utilizar somente um Worker próprio e revisar sua configuração.

⚠️ Compatibilidade e limitações

O funcionamento depende do formato do conteúdo, das informações disponibilizadas pela página, das permissões do navegador e das restrições impostas pelo site de origem.

• O projeto não remove DRM e não contorna paywalls, telas de login ou outros controles de acesso.
• Transmissões que dependem de DRM, incluindo Widevine, PlayReady, FairPlay e SAMPLE-AES, não são processadas.
• Faixas de vídeo e áudio separadas em determinados manifestos DASH não são combinadas pelo script.
• Alguns sites vinculam os endereços de mídia à sessão do player, à rede ou a tokens do navegador, impedindo o acesso direto.
• Alterações nas plataformas podem afetar a detecção e a compatibilidade sem aviso prévio.
• No iOS, o Safari pode exigir uma etapa adicional para salvar o arquivo.

Quando uma fonte não disponibiliza informações suficientes ou impede o acesso à mídia, o OPTDOWNS pode não conseguir concluir o processo. A ferramenta de diagnóstico ajuda a investigar essas situações, mas não garante que todo conteúdo seja acessível.

📌 Uso responsável

O OPTDOWNS foi desenvolvido para auxiliar no processamento e salvamento de conteúdos que o usuário tem autorização para armazenar, como vídeos próprios, materiais em domínio público, obras sob licenças abertas ou conteúdos cujo download seja permitido.

O usuário é responsável por...