Skip to content

Latest commit

 

History

History
102 lines (69 loc) · 8.58 KB

README.pt.md

File metadata and controls

102 lines (69 loc) · 8.58 KB

BoneCast 🦴📡

Novo na v0.5.4: notificações de atualização podem ser abertas no Steam. Uma janela adaptada ao comando mostra detalhes e, em caso de falha, um link para a versão.

Twitch e YouTube no Modo Jogo do Steam — um plugin do Decky Loader para Steam Deck / Bazzite / SteamOS.

🌍 Idiomas: English · Français · Deutsch · Español · Italiano · Português · Nederlands · Polski · Русский

Faz parte da suíte de plugins Necrosiak, ao lado de SkullKey, Steamcord e BC250-Toolkit. A interface do plugin está traduzida em 9 idiomas e segue automaticamente o idioma do SteamOS.


O que ele faz

O BoneCast coloca tudo o que você precisa para transmitir na Twitch diretamente no Menu de acesso rápido do Steam — sem desktop, sem teclado, pensado para o controle do login até entrar ao vivo.

  • Um único login na Twitch (código de dispositivo — amigável ao controle): você digita um código curto em twitch.tv/activate e o BoneCast obtém sua chave de transmissão automaticamente. Nunca mais copiar e colar.
  • ▶️ Aba YouTube (novo na 0.4.0) — entre ao vivo no YouTube com sua chave de transmissão, com ajustes próprios (resolução, bitrate, codificador, microfone, áudio do Discord, gravação), tela de pausa e microfone mudo ao vivo, além de um overlay do chat do YouTube sobre o jogo, sem conta. Uma única live e um único overlay de chat por vez: Twitch e YouTube nunca rodam juntos. Novo na 0.5.0: entre com sua conta do YouTube (um código em google.com/device) e o BoneCast cria a live para você, com título, visibilidade e seu próprio chat pelo QAM, sem chave de transmissão. Escolha a latência da live (normal, baixa ou ultrabaixa) (0.5.1).
  • Entre ao vivo pelo QAM — um botão inicia e para o fluxo RTMP. Um selo ● AO VIVO aparece enquanto você transmite.
  • Título da transmissão editável — definido no plugin, alterável mesmo ao vivo.
  • Categoria de jogo automática — lida do jogo Steam em execução (funciona também com atalhos não-Steam) e atualizada em tempo real. Se um jogo não tiver categoria correspondente na Twitch, usa-se Just Chatting.
  • Overlay de chat transparente — o chat da Twitch em somente leitura desenhado por cima do jogo no Modo Jogo (plano external-overlay do gamescope), com emotes nativos + BTTV / 7TV / FFZ. Posição, tamanho e opacidade se ajustam ao vivo pelo QAM, e ele continua visível mesmo com o Big Picture em foco. Subs, raids e bits (Twitch), Super Chats e novos membros (YouTube) aparecem como cartões destacados (0.5.0).
  • 📺 Assista à Twitch por cima do jogo — até quatro lives desenhadas sobre o jogo no Modo Jogo. Seus canais seguidos ao vivo aparecem com miniatura e número de espectadores: toque e a live começa. Disposição, tamanho, opacidade e taxa de quadros são ajustados no QAM; você escolhe qual som ouvir, com volume próprio, sempre na saída de áudio padrão. (Os canais seguidos exigem reconectar a Twitch uma vez após a atualização, para conceder a nova permissão.)
  • 🎬 Clipes instantâneos — ao vivo, um botão recorta os últimos ~30 segundos pela API da Twitch; o clipe chega ao seu painel cerca de 15 segundos depois.
  • 💬 Fale no seu próprio chat — envie mensagens para o seu chat da Twitch direto do QAM, sem malabarismo de teclado sobre o desktop.
  • ⏸️ Modo BRB — um toque substitui a imagem do jogo por uma tela de pausa limpa e silencia seu microfone; outro toque traz você de volta. A transmissão nunca cai. Sua própria tela de pausa (0.5.0): no modo Área de Trabalho, coloque uma imagem chamada brb.png na pasta BoneCast-BRB da sua pasta pessoal. Também animada (0.5.1): brb.mp4, brb.webm ou brb.gif, em loop.
  • ⏺️ Gravação local — salve sua sessão como MKV em ~/Vídeos/BoneCast/, em paralelo à transmissão ao vivo ou sem transmitir nada (nenhuma chave de transmissão envolvida). Salve no armazenamento interno, num cartão SD ou num disco externo (0.5.1).
  • Mudo do microfone ao vivo — corte seu microfone na transmissão com um toque, sem parar a transmissão (e sem silenciar sua chamada do Discord).
  • Configurações de transmissão por conta — resolução, fps, taxa de bits de vídeo/áudio, intervalo de quadros-chave e um codificador autodetectado (NVENC ▸ VAAPI ▸ x264 por software). Só são oferecidos os codificadores que realmente funcionam no seu hardware.
  • Ponte de áudio do Discord (quando o Steamcord está instalado): uma opção mistura sua voz do Discord na transmissão, para que seu grupo seja ouvido pelos espectadores — enquanto você continua a ouvi-los normalmente.

Como funciona

A Twitch não tem API de envio de vídeo, então entrar ao vivo sempre significa um push RTMP por baixo dos panos. O BoneCast cuida disso para você:

  1. O fluxo OAuth por código de dispositivo conecta você à Twitch e obtém sua chave de transmissão, título e categoria pela API Helix — você nunca toca na chave.
  2. A imagem do jogo é capturada do gamescope e passada diretamente ao ffmpeg por um pipe (sem câmera virtual, nada a instalar), que a codifica (por hardware quando disponível, com libx264 por software caso contrário) e a envia para rtmp://…/<sua-chave>.
  3. O overlay de chat é uma superfície WebKit transparente promovida ao plano external-overlay do gamescope, que lê o IRC da Twitch anonimamente e renderiza os emotes.

Tudo é controlado pelo QAM e sobrevive a reinicializações.


📸 Capturas de tela

Painel de entrar ao vivo

Instalação

  1. Instale o Decky Loader.
  2. Ative o Modo desenvolvedor nas configurações gerais do Decky, depois configurações do Decky → Desenvolvedor → Instalar plugin de URL: https://github.com/Necrosiak/BoneCast/releases/latest/download/BoneCast.zip (ou baixe o BoneCast.zip na página de Releases e instale a partir do ZIP).
  3. Abra o Menu de acesso rápido → BoneCast, faça login na Twitch e entre ao vivo.

O BoneCast se atualiza automaticamente pelas Releases do GitHub (desativável na seção Atualizações do plugin).


🐧 Compatibilidade

O BoneCast mira todas as distribuições Linux capazes de rodar o Steam no Modo Jogo / Big Picture: uma única build, detecção em tempo de execução de tudo o que é externo (ffmpeg, libx264, GStreamer), e o comando de instalação exato para o seu gerenciador de pacotes exibido no QAM quando algo falta. Notas de pacotes por distribuição: OS-NOTES.md.

🐛 Bugs e ideias — não hesite!

Encontrou um bug, algo se comporta mal na sua distribuição ou falta um recurso? Abra uma issue — cada relato orienta diretamente o que será construído em seguida. Se puder, inclua:

  • sua distribuição e versão (Bazzite 42, CachyOS, Ubuntu 24.04…) e sua GPU (para as sondas de codificador)
  • a versão do plugin e o que você estava fazendo (entrar ao vivo, overlay, OAuth…)
  • o que você esperava vs. o que aconteceu
  • os logs: ~/homebrew/logs/BoneCast/

Pedidos de recursos e relatos de «funciona!» em configurações incomuns são igualmente valiosos.

Créditos

Criado e mantido por Necrosiak. Faz parte da suíte de plugins Necrosiak para o Modo Jogo do Steam. Obrigado a dreemur-e pelos testes no Steam Deck OLED, pelas ideias para o YouTube e pelo vigia da captura que acabou com a imagem congelada (#1).

Aviso sobre IA

Foi usada IA (Claude da Anthropic e Codex da OpenAI) na criação deste projeto: para engenharia reversa, desenvolvimento e documentação. Não foi usada para arte nem escrita criativa. Tudo o que é publicado é revisto por um humano, e o resultado é da minha responsabilidade. Se isso o incomoda, fica avisado.

Apoie o desenvolvimento

Se este projeto é útil para si, pode apoiar o seu desenvolvimento contínuo no Ko-fi.

Apoie-me no Ko-fi