YT Stream Panel

🌐 1. Panoramica

YT Stream Panel è un pannello di controllo web professionale per gestire streaming live 24/7 su piattaforme come YouTube, Twitch, Kick, Facebook e qualsiasi server RTMP/RTMPS. Costruito con Flask (Python) e FFmpeg come motore di encoding, offre una soluzione completa per chi desidera trasmettere contenuti video in modo continuo, automatizzato e affidabile da un VPS Linux.

📂Multi-flussoGestisci più stream in parallelo, ognuno con le sue impostazioni indipendenti

🎨Overlay personalizzabiliWatermark, orologio live, ticker scorrevole, now playing con anteprima

🎬Intro & IntermezzoCountdown animato, video intro, stacchetti tra un contenuto e l'altro

🛡Watchdog intelligenteRiavvio automatico con backoff esponenziale in caso di crash

⏰Programmazione orariaAvvio/arresto automatico per fasce orarie, giorni e regole multiple

📊Monitoraggio real-timeBitrate, FPS, velocità, uptime e log live per ogni flusso attivo

📥Download ManagerScarica video da YouTube e altri siti con yt-dlp integrato

🔔Webhook e notificheNotifiche Discord, Telegram o webhook personalizzato per eventi stream

📰RSS TickerFeed RSS come testo scorrevole sovrapposto al video in tempo reale

💰Price Ticker CryptoPrezzi criptovalute live da CoinGecko con variazione 24h

🚀 2. Guida Rapida

Segui questi 4 passaggi per iniziare a trasmettere in meno di 5 minuti:

1

Configura la destinazione

Vai in Impostazioni → Destinazioni e aggiungi il tuo server RTMP. Usa i preset rapidi per YouTube o Twitch, oppure inserisci manualmente l'URL RTMP e la chiave di streaming.

2

Carica i media

In Media, carica file video, immagini e audio dal tuo computer, oppure usa il Download Manager per scaricare direttamente da YouTube e altri siti.

3

Crea un flusso

Nella tab Stream, clicca su Nuovo Flusso. Il wizard guidato in 6 step ti aiuterà a configurare: modalità, media, overlay, extra, output e riepilogo.

4

Avvia lo stream

Dalla card del flusso, premi ▶ Avvia. Monitora bitrate, FPS e log in tempo reale dalla tab Monitoraggio.

💡 Configura le notifiche webhook in Impostazioni → Automazione per ricevere avvisi su Discord o Telegram quando il flusso parte, si ferma o crasha.

📡 3. Flussi di Streaming

Ogni flusso è un'unità di streaming completamente autonoma con le proprie impostazioni di media, overlay, encoding e destinazione. Puoi avere più flussi attivi contemporaneamente.

Modalità disponibili

Modalità	Descrizione	Ideale per
📂 Playlist	Riproduce un elenco di video in sequenza (o shuffle), in loop infinito. Drag-and-drop per riordinare.	Cinema, musica, compilazioni
🎬 Video Singolo	Riproduce un singolo file in loop continuo, senza interruzioni.	Live cam, countdown, screensaver
🎵 Lo-Fi / Radio	Immagine statica (o slideshow) con musica in loop.	Lo-Fi radio, ambient, study music

Wizard di creazione (6 step)

Modalità — Scegli il tipo di flusso e assegna un nome
Media — Seleziona video, immagini e musica dal file explorer
Overlay — Configura watermark, orologio, ticker, now playing
Extra — Intro (video, immagine o countdown), intermezzi e transizioni
Output — Destinazioni RTMP, encoding, risoluzione e watchdog
Riepilogo — Revisione finale con programmazione oraria opzionale

Controlli e Stati

Badge	Stato	Significato
🟢	Live	Trasmette normalmente
⚪	Fermo	Configurato ma non attivo
🟡	Recovery	Il watchdog sta riavviando
🔴	Fallito	Tentativi esauriti
🔵	Programmato	In attesa dell'orario

🎨 4. Overlay

Sovrapposti al video tramite filtri FFmpeg. Configura i default in Impostazioni → Overlay, ereditati da ogni nuovo flusso. Ogni flusso può sovrascriverli.

Overlay	Descrizione	Opzioni
🖼 Watermark	Logo sovrapposto	Posizione (5 opzioni), scala (10-100%), opacità, margine
🎵 Now Playing	Nome file in riproduzione	Posizione, font, colore, sfondo con opacità
🕐 Orologio Live	Orologio real-time	Formato 12h/24h, timezone, posizione, colore
📢 Ticker Scorrevole	Testo scorrevole	Testo, velocità, direzione, font, sfondo
✅ Subscribe	Popup periodico "Iscriviti"	Testo, intervallo, durata, posizione, animazione, colore
📰 Lower Third	Titolo + sottotitolo stile TV	Titolo, sottotitolo, posizione, colori, animazione slide
💰 Price Ticker	Prezzi crypto live	Simboli (BTC, ETH, SOL...), colori up/down, valuta, separatore
🎶 Audio Visualizer	Barre audio animate	Stile (bars/wave), posizione, dimensione canvas, colore, opacità

⚠ Gli overlay richiedono ricodifica video (+10-20% CPU). Senza overlay, il video usa stream copy (zero CPU).

💡 Il ticker può essere alimentato da un feed RSS o price ticker crypto — vedi sezioni 13 e 14.

🎬 5. Extra (Intro, Intermezzo, Transizioni)

Arricchisci lo stream con contenuti professionali. Default globali in Impostazioni → Extra, personalizzabili per flusso.

Tipo	Descrizione	Uso tipico
🎬 Intro Video	File video mostrato una volta all'avvio	Sigla, trailer, animazione logo
🖼 Intro Immagine	Immagine statica con durata e audio opzionale	Benvenuto, banner sponsor
⏱ Countdown	Conto alla rovescia con testo, colori e barra	"Lo stream inizia tra..."
🔄 Intermezzo	Video tra ogni elemento della playlist (casuale se multipli)	Bumper, stacchetti, annunci

📁 6. Gestione Media

File manager integrato per gestire tutti i contenuti multimediali sul server.

📂 Navigazione cartelle con breadcrumb e tree view
⬆ Upload multiplo con drag & drop e barra di progresso
📁 Nuova cartella per organizzare i media
✏️ Rinomina file e cartelle inline
🔀 Sposta file/cartelle con drag & drop tra directory
☑️ Selezione multipla con barra azioni (elimina, sposta in blocco)
🖼 Image Tools — resize e crop immagini per ottimizzazione YouTube
🗑 Eliminazione con conferma
📥 Download da URL con yt-dlp integrato
👁 Anteprima immagini nel file explorer

Tipo	Formati	Note
🎬 Video	.mp4, .mkv, .avi, .mov, .ts, .webm	MP4 H.264 consigliato
🖼 Immagini	.jpg, .jpeg, .png, .bmp, .webp, .gif	PNG/JPG per watermark
🎵 Audio	.mp3, .aac, .ogg, .flac, .m4a, .wav	AAC per RTMP

💡 Puoi selezionare più file e applicare azioni in blocco dalla barra di selezione sempre visibile. Le immagini possono essere ridimensionate e ritagliate direttamente nel file manager.

📥 7. Download Manager

Utilizza yt-dlp per scaricare video e audio da YouTube e 1000+ siti, direttamente sul server.

Come usarlo

In Media, naviga nella cartella di destinazione
Clicca 📥 Download e inserisci l'URL
Seleziona il formato (best, 1080p, 720p, solo audio)
Clicca Scarica — barra di progresso mostra lo stato

Formato	Descrizione	Uso
best	Miglior qualità disponibile	Alta qualità
1080p	Full HD (1920×1080)	Standard YouTube
720p	HD (1280×720)	Risparmio disco
audio	Solo audio (MP3/AAC)	Canali Lo-Fi

🍪 Cookie per contenuti protetti

Per video che richiedono autenticazione, carica un file cookies.txt.

💡 Usa l'estensione browser "Get cookies.txt" per esportare i cookie in formato Netscape.

⚠ I cookie contengono le credenziali del tuo account. Non condividerli.

📊 8. Monitoraggio

Visione in tempo reale di tutti i flussi attivi, aggiornamento ogni 2 secondi.

Metrica	Descrizione	Valore ideale
📶 Bitrate	Velocità dati video	Vicino al configurato (es. 4500 kbps)
🎞 FPS	Frame per secondo	30 o 60 fps stabili
⚡ Velocità	Fattore velocità FFmpeg	≥1.0x (sotto = sovraccarico CPU)
🕐 Uptime	Tempo dall'avvio	Più alto possibile
📋 Log Live	Output FFmpeg	Nessun warning/errore

Console di sistema

Registra: ▶ avvii, ⏹ arresti, 💥 crash, 🛡 riavvii watchdog, ⏰ azioni scheduler, 🔔 webhook, ⚠ errori.

💡 Velocità sotto 1.0x? Usa preset ultrafast, abbassa risoluzione, o disattiva overlay.

⚙ 9. Encoding & Qualità

Configura in Impostazioni → Encoding o nello step 5 del wizard.

Parametro	Opzioni	Consigliato
Preset	ultrafast → medium	ultrafast per meno CPU
Bitrate Video	2500k – 12000k	4500k per 1080p
Bitrate Audio	128k – 320k	192k standard
Risoluzione	source, 720p, 1080p, 1440p	source se già corretta
Frame Rate	30 / 60 fps	30 fps standard

💡 L'encoding è usato solo con overlay attivi o risoluzione diversa. Senza, il video è in stream copy (CPU ~0%).

💡 Normalizzazione automatica: il sistema normalizza i video alla risoluzione/framerate target prima dello streaming, con una cache intelligente che evita ri-normalizzazioni inutili se le impostazioni che impattano l'output non sono cambiate.

📡 10. Destinazioni RTMP

Configura in Impostazioni → Destinazioni. Ogni destinazione ha ID, nome e URL RTMP completo.

Piattaforma	URL Base	Note
🔴 YouTube	rtmp://a.rtmp.youtube.com/live2	24/7 consentito
🟣 Twitch	rtmp://live.twitch.tv/app	Scegli server vicino
🟢 Kick	Nelle impostazioni Kick	Senza limitazioni
🔵 Facebook	rtmps://live-api-s.facebook.com:443/rtmp	Chiave rigenerata ogni sessione
🟡 Custom	Qualsiasi RTMP/RTMPS	Wowza, Nginx-RTMP, Owncast

💡 Multi-streaming: stesso flusso a più destinazioni in parallelo. Banda = bitrate × N destinazioni.

⏰ 11. Programmazione Oraria

Regole di avvio/arresto automatiche. Lo scheduler controlla ogni 30 secondi.

Seleziona giorni della settimana (Lun–Dom)
Imposta orari avvio/arresto (HH:MM)
Supporto fasce notturne (es. 22:00 → 06:00)
Più regole per coprire fasce diverse

Situazione	Azione
Nella fascia ma flusso fermo	Avvia automatico
Fuori fascia ma flusso attivo	Arresta automatico
In attesa	Stato "Programmato" con prossimo evento

⚠ Richiede server sempre acceso e servizio stream-panel attivo via systemd.

🔔 12. Webhook e Notifiche

Ricevi notifiche su Discord, Telegram o qualsiasi webhook HTTP per eventi stream.

Configurazione

Vai in Impostazioni → Automazione → Webhook Notifiche
Attiva le notifiche, inserisci URL webhook
Seleziona gli eventi da monitorare
Usa 🔔 Test per verificare

Evento	Trigger	Info incluse
▶ stream_start	Flusso avviato	Nome, destinazione, orario
■ stream_stop	Flusso arrestato	Nome, durata uptime
💥 stream_crash	FFmpeg termina	Nome, exit code, errore
🛡 watchdog_restart	Riavvio watchdog	Nome, tentativo #, delay

Esempi URL

Discord: https://discord.com/api/webhooks/ID/TOKEN
Telegram: https://api.telegram.org/botTOKEN/sendMessage?chat_id=CHAT_ID
Custom: Qualsiasi endpoint HTTP/HTTPS POST JSON

📰 13. RSS Ticker

Alimenta il ticker scorrevole con titoli da un feed RSS/Atom. Aggiornamento automatico in background.

Il sistema richiede il feed RSS all'URL configurato
Estrae i titoli degli ultimi articoli (max 10)
Li concatena con separatore ★ e li scrive in un file
FFmpeg li mostra come ticker scorrevole
Thread in background aggiorna ogni 5 minuti

Supporta RSS 2.0 (WordPress, Blogger) e Atom (GitHub, Google News).

💡 Perfetto per canali news. I titoli si aggiornano senza riavviare il flusso.

💰 14. Price Ticker Crypto

Prezzi criptovalute live come ticker scorrevole. API CoinGecko gratuita (no API key).

Simboli supportati

BTC Bitcoin
ETH Ethereum
SOL Solana
BNB Binance
XRP Ripple
ADA Cardano
DOGE Dogecoin
DOT Polkadot
AVAX Avalanche
MATIC Polygon
LINK Chainlink
LTC Litecoin
ATOM Cosmos
UNI Uniswap
SHIB Shiba Inu

BTC $67,432.15 ▲2.3% │ ETH $3,521.80 ▼0.8% │ SOL $148.92 ▲5.1%

Aggiornamento ogni 60 secondi. Valute: USD, EUR, GBP e altre.

💾 15. Backup e Ripristino

Esporta/importa la configurazione completa per backup o migrazione.

Include

✅ Flussi, overlay, extra, destinazioni, programmazioni, webhook
❌ File media (solo i path) e password

Come fare

Impostazioni → Avanzate → Backup / Ripristino
⬇ Esporta Config → file JSON completo
⬆ Importa Config → seleziona file JSON

⚠ L'importazione sovrascrive la configurazione corrente. Fai sempre backup prima.

🔒 16. HTTPS / SSL

Setup Nginx + Certbot (Let's Encrypt) per HTTPS auto-rinnovante.

Impostazioni → Avanzate → HTTPS
Inserisci dominio (es. stream.example.com)
Clicca 📄 Genera Script Setup
Esegui sul server: sudo bash setup-https.sh

Lo script installa Nginx, configura reverse proxy (porta 8080), ottiene certificato SSL e imposta rinnovo automatico + redirect HTTP→HTTPS.

💡 Il dominio deve già puntare al server (record A nel DNS) prima di eseguire lo script.

💡 17. Casi d'Uso

🎬Cinema 24/7Playlist film/serie con watermark e now playing

🎵Radio Lo-FiSlideshow + musica lo-fi in sottofondo continuo

📺Live CamVideo singolo in loop con orologio live

📢Canale NewsVideo + ticker RSS per notizie live

🎓DidatticaPlaylist lezioni con countdown e stacchetti

🎮Gaming RestreamMulti-streaming su YouTube, Twitch e Kick

🧘MeditazioneVideo natura con suoni ambientali e musica

📈Crypto / FinanzaGrafici con price ticker live da CoinGecko

🎙Podcast LiveEpisodi pre-registrati come live con countdown

🎸DJ SetSet continui con now playing e watermark

🌍 18. Guida Piattaforme

▶ YouTube

URL: rtmp://a.rtmp.youtube.com/live2
Key: YouTube Studio → Vai in diretta → Stream → Chiave stream
Nessun limite durata, 24/7 consentito, monetizzazione disponibile

💡 YouTube favorisce i live nelle ricerche. Canali 24/7 crescono 2-3x più velocemente.

▶ Twitch

URL: rtmp://live.twitch.tv/app (server più vicino)
Key: Dashboard → Impostazioni → Stream

▶ Facebook

Facebook Live Producer → Server RTMP personalizzato
Pagine: nessun limite durata. Profili: max 8 ore

⚠ Facebook rigenera la chiave ogni sessione.

▶ Kick

kick.com → Dashboard → Stream → RTMP credentials. 24/7 senza limiti.

▶ Custom RTMP

Compatibile con Wowza, Nginx-RTMP, Owncast e qualsiasi server RTMP/RTMPS.

🏆 19. Best Practices

📦 Formato Video

Codec: H.264 (AVC) — massima compatibilità
Container: MP4. Evita MKV per concatenazione
Evitare: H.265/HEVC e AV1 — non supportati via RTMP

⚡ Performance

1 flusso 1080p ≈ 1 core CPU + 5 Mbps upload
Multi-streaming: banda × N destinazioni
Preset ultrafast per minimizzare CPU

🛡 Affidabilità

Watchdog: backoff esponenziale (2s → 60s), max 10 tentativi
Programmazione oraria per restart giornaliero automatico
Badge salute: 🟢 stabile, 🟡 recovery, 🔴 fallito

💰 Crescita

Live 24/7 accumulano watch hours più velocemente
YouTube prioritizza contenuti live nelle ricerche
Ticker per promuovere social e inviti all'iscrizione

🔧 20. Troubleshooting

Il flusso si ferma subito

Controlla log FFmpeg in Monitoraggio
Verifica URL RTMP e stream key
Verifica che file video e watermark esistano

Velocità sotto 1.0x

Preset → ultrafast
Risoluzione → 720p
Disattiva overlay non essenziali
Meno flussi contemporanei

Watchdog in loop

Verifica connettività internet
Controlla che la piattaforma non abbia bloccato l'account
Stream key scaduta? (Facebook rigenera)

Download non funzionano

Verifica yt-dlp installato
Aggiorna: pip install --upgrade yt-dlp
Cookie aggiornati per contenuti protetti

Pannello non si carica

systemctl status stream-panel
journalctl -u stream-panel -n 50
sudo systemctl restart stream-panel

🏗 21. Architettura Tecnica

Componente	Tecnologia	Ruolo
Backend	Python 3 + Flask	API REST, flussi, scheduler
Encoding	FFmpeg	Trascodifica, overlay, RTMP
Frontend	HTML5 + CSS3 + JS	UI, wizard, monitoraggio
Download	yt-dlp	Video da 1000+ siti
Prezzi	CoinGecko API	Price ticker crypto
Servizio	systemd	Processo, auto-restart
HTTPS	Nginx + Certbot	SSL, reverse proxy

API Endpoints

Flussi

GET/api/flowsLista flussi

POST/api/flowsCrea flusso

POST/api/flows/{id}Aggiorna flusso

POST/api/flows/{id}/deleteElimina flusso

POST/api/flows/{id}/startAvvia flusso

POST/api/flows/{id}/stopArresta flusso

POST/api/flows/{id}/previewGenera anteprima

Media

GET/api/media/listLista file/cartelle

POST/api/media/uploadUpload file

POST/api/media/renameRinomina file

POST/api/media/moveSposta file

POST/api/media/deleteElimina file

POST/api/media/resizeResize immagine

POST/api/media/cropCrop immagine

Download

POST/api/downloadAvvia download (yt-dlp)

GET/api/download/statusStato download attivi

Monitoraggio & Impostazioni

GET/api/monitoringMetriche real-time

GET/statusStato generale (no auth)

POST/api/settingsAggiorna impostazioni

GET/api/settings/exportEsporta config (JSON)

POST/api/settings/importImporta config (JSON)

❓ 22. FAQ

Quanti flussi posso avviare?

Dipende dalle risorse: 1 flusso 1080p ≈ 1 core CPU. Un VPS 4 core gestisce 3-4 flussi.

Cos'è il Watchdog?

Rileva crash e riavvia con backoff esponenziale. Dopo 10 tentativi falliti, si arresta e notifica.

Posso usare cookie per i download?

Sì, carica un file cookies.txt in Media per scaricare video protetti.

I default sovrascrivono i flussi?

No. Sono solo valori iniziali nel wizard. Ogni flusso ha impostazioni indipendenti.

FFmpeg è incluso?

No, va installato: sudo apt install ffmpeg

Miglior formato video?

MP4 H.264 + AAC. Evita MKV per concatenazione e H.265/AV1 (non supportati RTMP).

Il 24/7 è permesso su YouTube?

Sì, YouTube consente e incoraggia lo streaming continuo.

Come trovo la Stream Key YouTube?

YouTube Studio → Vai in diretta → Stream → Chiave stream. URL: rtmp://a.rtmp.youtube.com/live2

Cosa succede se il server si riavvia?

I flussi con programmazione oraria si riavviano automaticamente. I manuali vanno riavviati dal pannello.

Come configuro notifiche Discord?

Crea webhook Discord (Impostazioni Canale → Integrazioni → Webhook), incolla URL in Impostazioni → Automazione.

Prezzi crypto sullo stream?

Sì! Price Ticker Crypto con 15+ simboli da CoinGecko, aggiornamento ogni 60s, gratuito.

Come aggiorno yt-dlp?

SSH → pip install --upgrade yt-dlp

Posso fare backup?

Sì, in Impostazioni → Avanzate → Backup / Ripristino. Export JSON di tutta la config.

Monitoraggio remoto?

Webhook per notifiche su Discord/Telegram. Per monitoraggio avanzato, pannello browser o API REST.

Cos'è la normalizzazione automatica?

Il sistema normalizza automaticamente i video alla risoluzione e framerate target. Una cache intelligente evita di ri-normalizzare se le impostazioni rilevanti non sono cambiate.

Come funziona il drag & drop nel file manager?

Trascina file e cartelle per spostarli tra directory. Supporta anche selezione multipla per operazioni in blocco (elimina, sposta).

Cos'è l'Audio Visualizer?

Un overlay che mostra barre animate sincronizzate con l'audio del flusso. Disponibile in stile "bars" o "wave", ideale per canali musicali e Lo-Fi radio.

Come fare deploy senza interrompere gli stream?

Usa deploy.ps1 che esegue un graceful restart: salva i flussi attivi, riavvia il servizio, e li ripristina automaticamente.

Posso ridimensionare le immagini?

Sì! Nel File Manager, seleziona un'immagine e usa gli strumenti Resize/Crop per ottimizzarla per YouTube (1920×1080, miniature, etc.).

🔐 Login

📡 Dashboard

Nuovo Flusso

🖥 Server

📋 Console Log

✂ Modifica Immagine

🖼 Slideshow Lo-Fi

Gestione Slideshow

📥 Download YouTube

⚙️ Impostazioni

🎨 Overlay (Default)

🎬 Extra (Default)

🔧 Generale

🎬 Encoding

📡 Destinazioni RTMP

🎛 Preset Encoding

🔑 Sicurezza

💾 Backup / Ripristino

🎬 Anteprime Stream

⏰ Programmazione Oraria

🔔 Webhook Notifiche

🍪 Cookie YouTube

🛠 Versioni e Aggiornamenti

🔒 HTTPS (Nginx + Certbot)

📖 Documentazione

Indice