Plugin Cam Stream no Omarchy

O Cam Stream inverte a lógica das transmissões com cena montada. Em vez de reconstruir as janelas dentro de um quadro fixo, você monta o desktop como quer que o público veja e captura o resultado. A câmera vira uma janela comum: move, redimensiona, coloca lado a lado, deixa flutuando ou esconde durante a transmissão.

O vídeo da câmera preenche a janela conforme o layout muda. Câmera e captura mantêm estado separado: iniciar ou encerrar uma gravação não mexe na janela da câmera, então a composição na tela continua sob seu controle.

Antes de instalar

O plugin exige Omarchy 4 Quattro com shell Quickshell e uma câmera acessível por V4L2. A prévia usa mpv e as ferramentas v4l2-ctl, do pacote v4l-utils, além do flock, do util-linux. Esses pacotes acompanham o Omarchy 4.

Gravar e transmitir também usam gpu-screen-recorder, ffmpeg para finalizar a cópia local em MP4 e secret-tool, do libsecret, com um chaveiro Secret Service desbloqueado. hyprctl e jq são opcionais e melhoram o posicionamento da janela. O fuser, do psmisc, é opcional e informa qual processo está ocupando a câmera.

Instale e revise o código

Plugins do Omarchy rodam sem isolamento dentro do shell. O README sugere revisar o checkout antes de habilitar:

1
omarchy plugin add https://github.com/tomdavenport/cam-stream.git
2
cd "$HOME/.config/omarchy/plugins/io.github.tomdavenport.cam-stream"
3
less manifest.json BarWidget.qml bin/cam-stream
4
omarchy plugin enable io.github.tomdavenport.cam-stream --section right

Para instalar e habilitar de uma vez:

1
omarchy plugin add https://github.com/tomdavenport/cam-stream.git --enable

O widget fica na seção direita da barra e pode ser movido depois pelas configurações da barra.

Controle a câmera

O clique esquerdo liga e desliga a prévia, inclusive durante uma gravação ou transmissão. O clique direito abre o painel com as abas Camera, Record e Live Stream, o clique do meio atualiza o estado e a tecla R atualiza com o painel em foco.

A câmera escolhida, o espelhamento e a preferência de latência ficam salvos no diretório de configuração do plugin. Trocar de câmera ou de modo durante a prévia reinicia a reprodução para aplicar a mudança. O modo Realtime, padrão, segue o caminho de baixa latência do mpv. O modo Smoother acrescenta latência para estabilizar os quadros.

Grave a tela

Escolha Full screen, Window ou Region, defina a fonte de áudio e pressione Start recording. A tela cheia grava o monitor em foco. Janela e região abrem o seletor do Omarchy a cada gravação. O modo de captura fica gravado. A janela e o retângulo específicos, não.

As gravações ficam na pasta de vídeos do usuário, no modo de qualidade muito alta do GPU Screen Recorder. Pausar, retomar e parar afetam apenas o processo iniciado pelo Cam Stream. A gravação não liga nem desliga a câmera.

Transmita ao vivo

O plugin tem dois destinos: o perfil X e um perfil Custom com endereço RTMP ou RTMPS. O X sempre usa RTMPS. O Cam Stream não faz login nem publica por você: ele envia para o endereço de ingestão que o X Live Studio fornece, e abrir a transmissão continua sendo uma ação dentro do X.

1. Abra o X Live Studio e crie ou selecione uma fonte.
2. Cole a URL rtmps:// e a chave de transmissão no Cam Stream e confirme.
3. Escolha captura, áudio e qualidade, e pressione Start sending.
4. Confira a prévia e publique a transmissão no X.

O painel informa Sending to X, sem afirmar que a transmissão já está pública. Os perfis ao vivo usam 6 Mbps em 720p30, 8 Mbps em 1080p30 e 12 Mbps em 1080p60. A cópia local vem ligada por padrão e usa a mesma codificação. Ao encerrar, o plugin converte o arquivo para MP4 sem recodificar.

As chaves ficam no chaveiro do sistema, fora da configuração e dos logs. Sem um Secret Service utilizável, o envio é recusado em vez de gravar a chave em texto simples.

Atualize e remova

1
omarchy plugin update io.github.tomdavenport.cam-stream

A atualização mostra as alterações recebidas e exige confirmação antes de aplicar. Para encerrar transmissão, gravação e prévia antes de remover:

1
cam_stream="$HOME/.config/omarchy/plugins/io.github.tomdavenport.cam-stream/bin/cam-stream"
2
"$cam_stream" live stop
3
"$cam_stream" record stop
4
"$cam_stream" stop
5
omarchy plugin remove io.github.tomdavenport.cam-stream

A remoção apaga o checkout do plugin e mantém suas preferências e o histórico de diagnóstico. Se quiser limpar também esses arquivos, remova ~/.config/cam-stream e ~/.local/state/cam-stream depois de parar a prévia.