Abrir no Haruna wót Lu15-F3

Abrir no Haruna é uma extensão leve e eficiente projetada para usuários de Linux (especialmente no Fedora) que utilizam o player de mídia Haruna (baseado em MPV) e desejam uma integração nativa com o Firefox.

Com esta extensão, você não precisa mais copiar e colar URLs de vídeos do navegador para o player. Basta clicar com o botão direito em qualquer link de vídeo (como YouTube, Vimeo e dezenas de outros sites suportados pelo yt-dlp) e selecionar "Abrir no Haruna". O vídeo começará a tocar instantaneamente no seu player local!

✨ Recursos

• Integração Nativa: Abre o Haruna Player (versão RPM/nativa) em background com apenas um clique.
• Privacidade Total: A extensão não coleta, armazena ou envia nenhum tipo de dado de navegação ou telemetria.
• Super Leve: Escrita em JavaScript puro (Vanilla JS), sem frameworks pesados rodando em segundo plano.

⚠️ IMPORTANTE: Configuração Necessária (Linux/Fedora)

Por questões de segurança do Firefox, extensões de navegador não podem abrir programas diretamente no seu sistema. Para que esta extensão funcione, você precisa instalar um pequeno script intermediário (Native Host) na sua máquina.

🚀 Instalação Automatizada (Recomendado)

Abra o terminal do seu Fedora/Linux e execute o comando abaixo para instalar todos os arquivos locais necessários de forma automática:

curl -sSL "https://raw.githubusercontent.com/Lu15-F3/haruna-firefox-opener/main/install.sh" | bash

(Você também pode inspecionar o conteúdo do script install.sh diretamente no nosso repositório antes de rodar).

Esse comando vai criar os diretórios necessários, baixar o script de comunicação nativa e configurar os caminhos corretos de forma segura para o seu usuário.

⚙️ Ativação

1. Execute o comando de instalação automatizada acima no seu terminal.
2. Instale esta extensão aqui na loja do Firefox.
3. (Opcional) Ative a permissão para janelas privativas nas configurações da extensão, caso deseje usar o recurso no modo anônimo.

📦 Código Aberto e Transparência

As instruções detalhadas para instalação manual e todo o código-fonte estão disponíveis publicamente no repositório oficial do projeto:
👉 https://github.com/Lu15-F3/haruna-firefox-opener

📦 Notas sobre Flatpak / Snap

Esta extensão foi projetada para as versões nativas (RPM/DEB) do Firefox e do Haruna. Se você utiliza as versões em Flatpak ou Snap, os caminhos das pastas mudam devido ao isolamento do sistema:

• Firefox em Flatpak: O arquivo org.custom.haruna.json deve ser movido para:
  ~/.var/app/org.mozilla.firefox/.mozilla/native-messaging-hosts/
• Haruna em Flatpak: Pode ser necessário editar o script haruna_wrapper.py para chamar o player usando o comando flatpak run org.kde.haruna em vez de apenas haruna.