Plugin OmaSound AirPlay no Omarchy

O OmaSound AirPlay coloca as caixas AirPlay da sua rede dentro do menu de áudio do Omarchy. Você marca uma ou mais caixas na lista e o som que já está em reprodução no navegador, no player ou em qualquer aplicativo sai por elas. Não existe comando de reprodução para decorar.

Em casa, a configuração rende quando o computador precisa alcançar mais de um ambiente. Cada caixa marcada ganha um controle de volume próprio e o botão Sync Volume iguala o grupo pela média antes de manter os volumes ligados entre si. O volume geral, o mudo e as teclas do teclado acompanham a caixa ativa ou a média do grupo.

A descoberta usa o Avahi para achar receptores IPv4, inclusive os que publicam serviço de áudio sem registro RAOP separado. O envio fica com o cliairplay, que agenda o mesmo instante de início em todas as caixas. O menu herda as cores do tema ativo e convive com a saída local, o microfone e o misturador por aplicativo que o Omarchy já oferece.

A versão 0.1.0 é uma prévia. O autor testou dois HomePods com reprodução simultânea de música e o pacote portátil ainda precisa de um teste em instalação limpa de outra máquina. Receptores que exigem pareamento, senha ou protocolo diferente aparecem na descoberta sem garantia de reprodução.

Antes de instalar

O plugin exige Omarchy com a API de plugins do Quickshell, o serviço de compatibilidade PulseAudio do PipeWire e uma rede local que permita descoberta multicast. A versão atual publica checksums de remetente para x86_64 e aarch64, mas apenas a x86_64 foi exercitada. Pareamento por PIN ou senha, redes apenas IPv6 e grupos multiroom com gerações misturadas não funcionam nesta versão.

O OmaSound entra no lugar do widget omarchy.audio original usando os metadados de clone que o Omarchy suporta. Caso já use outro clone do widget de áudio, desabilite-o nas configurações da barra e coloque o OmaSound na posição dele, deixando um único clone de áudio ativo. Uma instalação que ainda mantém o protótipo de desenvolvimento precisa parar o airplay-audio.service antes da troca, porque este pacote não altera esse serviço nem importa as configurações dele.

Instale e configure

1
omarchy plugin add https://github.com/fterenas/omarchy-omasound-airplay.git --enable && python3 ~/.config/omarchy/plugins/io.github.fterenas.omasound-airplay/bin/setup.py

O setup.py abre um terminal, explica as mudanças e pergunta antes de aplicar. Ele instala os pacotes que faltam, habilita a descoberta pelo Avahi e baixa o binário cliairplay 0.5.5 com verificação de checksum. O remetente fica em /usr/local/lib/omasound-airplay/cliairplay, com permissão para abrir as portas de tempo (cap_net_bind_service=ep) e executa com o seu usuário.

O mesmo passo está no menu, em Áudio → Set up / repair AirPlay. A instalação do plugin em si não roda script de setup nem faz mudança privilegiada, então cancelar o assistente deixa os controles locais como estavam. Numa cópia local do repositório, python3 bin/setup.py faz o mesmo trabalho.

Conecte as caixas

1. Espere até 20 segundos para as caixas aparecerem no menu de áudio.
2. Marque as caixas que quer usar. A reprodução que já estava em andamento muda para a saída escolhida.
3. Ajuste os controles individuais ou ligue o Sync Volume. Com 30% e 70%, as duas caixas ficam em 50%. Com 35% e 70%, as duas caixas ficam em 53%.
4. Escolha uma saída física ou desmarque todas as caixas para voltar ao áudio local.

Trocar o grupo reinicia as conexões e pode interromper o som por um instante. Até oito caixas podem ser marcadas e o grupo testado tem duas. A última seleção e os volumes por caixa ficam gravados e voltam quando o plugin inicia.

Firewall e limites de rede

Com o UFW ativo, marcar uma caixa que precisa das portas de tempo do AirPlay 2 abre uma solicitação de administrador para uma entrada UDP 319 a 320, vinda só do IPv4 daquela caixa. Uma entrada que já existia é reaproveitada e o plugin não assume como dele uma abertura anterior. Nenhum passo desliga o firewall inteiro.

Uma caixa que troca de endereço precisa de entrada nova e as aberturas antigas podem sair na limpeza descrita abaixo.

Atualize e remova

1
omarchy plugin update io.github.fterenas.omasound-airplay

Desabilitar o OmaSound pelo Omarchy interrompe o worker e os fluxos de áudio e devolve o widget embutido, com até 15 segundos para encerrar as conexões. Pacotes compartilhados, remetente, configurações e aberturas de firewall continuam no sistema. Para limpar as dependências, rode a limpeza antes de apagar o checkout:

1
python3 "$HOME/.config/omarchy/plugins/io.github.fterenas.omasound-airplay/bin/uninstall.py" && omarchy plugin remove io.github.fterenas.omasound-airplay

A limpeza desabilita o plugin, apaga o remetente dedicado com a permissão de portas e oferece remover cada liberação de portas criada pelo OmaSound. Liberações anteriores ficam. O estado em ${XDG_STATE_HOME:-$HOME/.local/state}/omasound-airplay é mantido. Apague esse diretório à parte para esquecer as caixas e os volumes.