Skip to content

README.it.md

Latest commit

 

History

History
100 lines (68 loc) · 8.5 KB

README.it.md

File metadata and controls

100 lines (68 loc) · 8.5 KB
Raw

BoneCast 🦴📡

Twitch e YouTube nella Modalità Gioco di Steam — un plugin Decky Loader per Steam Deck / Bazzite / SteamOS.

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

Fa parte della suite di plugin Necrosiak, insieme a SkullKey, Steamcord e BC250-Toolkit. L'interfaccia del plugin è tradotta in 9 lingue e segue automaticamente la lingua di SteamOS.

Cosa fa

BoneCast mette tutto il necessario per trasmettere su Twitch direttamente nel Menu di accesso rapido di Steam — niente desktop, niente tastiera, pensato per il controller dal login fino alla diretta.

  • Un solo accesso a Twitch (codice dispositivo — adatto al controller): inserisci un codice breve su twitch.tv/activate e BoneCast recupera la tua chiave di trasmissione automaticamente. Mai più copia-incolla.
  • ▶️ Scheda YouTube (novità della 0.4.0) — vai in live su YouTube con la tua chiave stream, con impostazioni proprie (risoluzione, bitrate, encoder, microfono, audio Discord, registrazione), schermata di pausa e microfono silenziabile in diretta, più un overlay della chat YouTube sopra il gioco, senza account. Una sola live e un solo overlay chat alla volta: Twitch e YouTube non girano mai insieme. Novità della 0.5.0: accedi con il tuo account YouTube (un codice su google.com/device) e BoneCast crea la live per te, con titolo, visibilità e la tua chat dal QAM, senza chiave stream. Scegli la latenza della diretta (normale, bassa o ultra-bassa) (0.5.1).
  • Vai in diretta dal QAM — un pulsante avvia e ferma il flusso RTMP. Un badge ● IN DIRETTA compare mentre trasmetti.
  • Titolo della diretta modificabile — impostato dal plugin, modificabile anche in diretta.
  • Categoria di gioco automatica — letta dal gioco Steam in esecuzione (funziona anche con i collegamenti non-Steam) e aggiornata al volo. Se un gioco non ha una categoria Twitch corrispondente, si passa a Just Chatting.
  • Overlay della chat trasparente — la chat di Twitch in sola lettura disegnata sopra il gioco in Modalità Gioco (piano external-overlay di gamescope), con emote native + BTTV / 7TV / FFZ. Posizione, dimensione e opacità si regolano in tempo reale dal QAM, e resta visibile anche con Big Picture in primo piano. Sub, raid e bits (Twitch), Super Chat e nuovi membri (YouTube) appaiono come schede evidenziate (0.5.0).
  • 📺 Guarda Twitch sopra il gioco — fino a quattro live disegnate sopra il gioco in Modalità Gioco. I tuoi canali seguiti in diretta sono elencati con miniatura e numero di spettatori: toccane uno e parte. Disposizione, dimensione, opacità e frame rate si regolano dal QAM; scegli quale audio ascoltare, con il suo volume, sempre sull'uscita audio predefinita. (I canali seguiti richiedono di ricollegare Twitch una volta dopo l'aggiornamento, per concedere il nuovo permesso.)
  • 🎬 Clip istantanee — in diretta, un pulsante ritaglia gli ultimi ~30 secondi tramite l'API di Twitch; la clip arriva sulla tua dashboard circa 15 secondi dopo.
  • 💬 Parla nella tua chat — invia messaggi nella tua chat di Twitch direttamente dal QAM, senza acrobazie con tastiera e desktop.
  • ⏸️ Modalità BRB — un tocco sostituisce l'immagine del gioco con una schermata di pausa pulita e silenzia il microfono; un altro tocco ti riporta in gioco. La trasmissione non si interrompe mai. La tua schermata di pausa (0.5.0): dalla modalità Desktop, metti un’immagine chiamata brb.png nella cartella BoneCast-BRB della tua cartella home. Anche animata (0.5.1): brb.mp4, brb.webm o brb.gif, in loop.
  • ⏺️ Registrazione locale — salva la tua sessione come MKV in ~/Video/BoneCast/, in parallelo alla diretta oppure senza trasmettere affatto (nessuna chiave di trasmissione coinvolta). Salva nella memoria interna, su una scheda SD o su un disco esterno (0.5.1).
  • Muto del microfono in diretta — taglia il microfono sulla trasmissione con un tocco, senza fermare la diretta (e senza silenziare la tua chiamata Discord).
  • Impostazioni di trasmissione per account — risoluzione, fps, bitrate video/audio, intervallo dei keyframe e un encoder rilevato automaticamente (NVENC ▸ VAAPI ▸ x264 software). Vengono proposti solo gli encoder che funzionano davvero sul tuo hardware.
  • Ponte audio Discord (se Steamcord è installato): un interruttore opzionale mixa la tua voce Discord nella trasmissione, così il tuo gruppo viene sentito dagli spettatori — mentre tu continui a sentirli normalmente.

Come funziona

Twitch non ha un'API di push video, quindi andare in diretta significa sempre un push RTMP dietro le quinte. BoneCast se ne occupa per te:

  1. Il flusso OAuth con codice dispositivo ti connette a Twitch e recupera chiave di trasmissione, titolo e categoria tramite l'API Helix — non tocchi mai la chiave.
  2. L'immagine del gioco viene catturata da gamescope e passata direttamente a ffmpeg tramite una pipe (nessuna videocamera virtuale, niente da installare), che la codifica (hardware quando disponibile, libx264 software altrimenti) e la invia a rtmp://…/<la-tua-chiave>.
  3. L'overlay della chat è una superficie WebKit trasparente promossa sul piano external-overlay di gamescope, che legge l'IRC di Twitch in forma anonima e mostra le emote.

Tutto si controlla dal QAM e sopravvive ai riavvii.

📸 Screenshot

Pannello per andare in diretta

Installazione

  1. Installa Decky Loader.
  2. Attiva la Modalità sviluppatore nelle impostazioni generali di Decky, poi impostazioni Decky → Sviluppatore → Installa plugin da URL: https://github.com/Necrosiak/BoneCast/releases/latest/download/BoneCast.zip (oppure scarica BoneCast.zip dalla pagina delle Releases e installalo dallo ZIP).
  3. Apri il Menu di accesso rapido → BoneCast, accedi a Twitch e vai in diretta.

BoneCast si aggiorna automaticamente dalle Releases di GitHub (disattivabile nella sezione Aggiornamenti del plugin).

🐧 Compatibilità

BoneCast punta a tutte le distribuzioni Linux in grado di eseguire Steam in Modalità Gioco / Big Picture: una sola build, rilevamento a runtime di tutto ciò che è esterno (ffmpeg, libx264, GStreamer), e il comando di installazione esatto per il tuo gestore di pacchetti mostrato nel QAM quando manca qualcosa. Note sui pacchetti per distribuzione: OS-NOTES.md.

🐛 Bug e idee — non esitare!

Hai trovato un bug, qualcosa si comporta male sulla tua distribuzione o manca una funzione? Apri una issue — ogni segnalazione orienta direttamente ciò che verrà costruito dopo. Se puoi, includi:

  • la tua distribuzione e versione (Bazzite 42, CachyOS, Ubuntu 24.04…) e la tua GPU (per le sonde dell'encoder)
  • la versione del plugin e cosa stavi facendo (andare in diretta, overlay, OAuth…)
  • cosa ti aspettavi rispetto a cosa è successo
  • i log: ~/homebrew/logs/BoneCast/

Le richieste di funzionalità e i report «funziona!» su configurazioni insolite sono altrettanto preziosi.

Crediti

Creato e mantenuto da Necrosiak. Fa parte della suite di plugin Necrosiak per la Modalità Gioco di Steam. Grazie a dreemur-e per i test su Steam Deck OLED, le idee per YouTube e il watchdog della cattura che ha risolto l’immagine bloccata (#1).

Nota sull'IA

L'IA (Claude di Anthropic e Codex di OpenAI) è stata usata nella realizzazione di questo progetto: per reverse engineering, sviluppo e documentazione. Non per grafica o scrittura creativa. Tutto ciò che viene pubblicato è riletto da un umano, e il risultato resta sotto la mia responsabilità. Se la cosa ti dà fastidio, ora lo sai.

Sostieni lo sviluppo

Se questo progetto ti è utile, puoi sostenere il suo sviluppo continuo su Ko-fi.

Sostienimi su Ko-fi