YTweaks

Extensao para Chrome e Firefox com tweaks personalizados para o YouTube.

Funcionalidades

• Shorts como video normal — links de Shorts abrem direto no player /watch (sem reload, historico correto), via interceptacao de pushState, rewrite de links e redirect precoce de navegacao
• Esconder Shorts — toggle global ou por local: menu lateral, home, busca, inscricoes, canais, sugestoes (watch) e trending
• Pagina de video — esconder videos recomendados e/ou painel de playlist (a playlist e preservada automaticamente quando a URL tem list=)
• Layout com playlist — quando os relacionados estao ocultos e a playlist esta visivel, descricao, comentarios e demais detalhes ocupam tambem a largura da playlist
• Tamanho do player — padrao do YouTube, medio (cabe na tela) ou largura total quando a lateral esta escondida
• Velocidade ao segurar — desabilita o 2x temporario ao segurar o mouse ou a barra de espaco; a barra de espaco alterna play/pause normalmente
• Qualidade do video — trava a qualidade em 480p/720p/1080p/1440p/4K; se o video nao tiver a escolhida, aplica a mais alta disponivel
• Icone de estado — fica cinza quando o toggle principal esta desligado

Instalacao (desenvolvimento)

Chrome

1. Acesse chrome://extensions
2. Ative o Modo do desenvolvedor
3. Carregar sem compactacao e selecione esta pasta

Firefox

1. Renomeie manifest-firefox.json para manifest.json
2. Acesse about:debugging#/runtime/this-firefox
3. Carregar extensao temporaria e selecione o manifest.json

Build para publicacao

Os manifestos do Chrome e do Firefox sao diferentes. Gere um pacote .zip para cada loja:

# Chrome Web Store (usa service_worker)
npx web-ext build --source-dir . --artifacts-dir dist --filename YTweaks-chrome.zip --ignore-files manifest-firefox.json

# Firefox Add-ons (AMO) — usa background scripts
mv manifest-firefox.json manifest.json
npx web-ext build --source-dir . --artifacts-dir dist --filename YTweaks-firefox.zip --ignore-files manifest-chrome.json

Para validar o manifest do Firefox localmente:

mv manifest-firefox.json manifest.json
npx web-ext lint

Nota: O manifest.json raiz esta configurado para a Chrome Web Store (MV3 com service_worker).

Estrutura

manifest.json            MV3 para Chrome Web Store
manifest-chrome.json     Copia do manifest.json (Chrome Web Store)
manifest-firefox.json    MV3 para Firefox Add-ons (AMO)
background.js            service worker / event page: redirect de URL direta + icone de estado
content.js              rewrite de links, classes de contexto, expansao do player, cache de titulos
page-hook.js            world MAIN: intercepta navegacao + qualidade + velocidade temporaria + titulos
features/hide-shorts.css
popup/                  interface dos toggles (localizada via _locales)
_locales/               en + pt_BR
icons/                  svg fonte + pngs gerados

Permissoes

• storage — salvar preferencias do usuario
• webNavigation — interceptar navegacao para /shorts/ e redirecionar antes do carregamento
• host_permissions em *://*.youtube.com/* — aplicar as configuracoes apenas no YouTube

Privacidade

A extensao nao coleta dados pessoais. A unica comunicacao de rede e o fetch publico para https://www.youtube.com/oembed, usado apenas para exibir titulos originais quando o usuario ativa essa opcao.

Licenca

MIT