Mattia Prosperi
Tutti i progetti
Automazioni e strumentiin sviluppo

Media Server

Una piattaforma di streaming privata, scritta da zero — un mini PC sempre acceso tiene film, serie e musica e li porta su televisori e telefoni, dentro e fuori casa, con un'app dal nome scelto da chi la usa.

Che cos’è

Un media server è un computer che custodisce una raccolta di video e musica e la offre agli altri dispositivi come fa un servizio di streaming: locandine, trame, « continua a guardare », un profilo per ogni persona. Di solito si usano Plex o Jellyfin; questo l’ho scritto da zero, server e app.

A casa mia si chiama Prosperi TV, ma il nome è solo il mio: nome e logo dell’app saranno personalizzabili, così chi lo installa ha la sua piattaforma, col suo marchio, sui suoi dispositivi.

Come funziona

  1. Si mette un file in una cartella del server: un film, la puntata di una serie, un album.
  2. Il server lo riconosce dal nome, lo rinomina in modo ordinato e recupera da solo locandina, trama, anno, cast, copertina del disco.
  3. Compare nell’app di tutti, sul televisore e sul telefono, già al suo posto: nella serie giusta, alla stagione giusta, sotto l’artista giusto.
  4. Si preme play e il video arriva in streaming. Si può saltare avanti e indietro senza aspettare che si scarichi, e riprendere dallo stesso punto su un altro dispositivo.
  5. Se un dispositivo non sa leggere quel formato, il server lo converte di notte in uno che va ovunque, senza toccare l’originale.
  6. Fuori casa funziona uguale, a un indirizzo fisso, solo per gli utenti invitati.

I pezzi del sistema

  • Il server, su un mini PC acceso giorno e notte, con i dischi della libreria. Gira come servizio di Windows e si rialza da solo se cade.
  • Le app per Android, Android TV e Fire Stick, una sola base di codice: sul televisore si usa col telecomando, sul telefono ha la sua barra. Profili dentro l’account come su Netflix, ognuno con cronologia, « La mia lista » ed eventuale limite d’età; pulsante « prossimo episodio », pagine di attori e registi, lettore musicale. Si aggiornano da sole, scaricando la versione nuova dal server.
  • Il manager desktop, per amministrare dal PC: libreria, profili, utenti, conversioni, riavvio del server.

Il lavoro che fa da solo

  • Converte di notte i video che qualche dispositivo non regge (HEVC, HDR, Dolby Vision, 4K sulla chiavetta TV), solo in una finestra oraria e mai mentre qualcuno guarda.
  • Controlla che le serie siano complete, confrontando la libreria con l’elenco ufficiale di stagioni ed episodi.
  • Raccoglie le richieste: chi non è amministratore chiede un titolo dall’app, e la richiesta diventa « in libreria » da sola quando arriva.
  • Una sentinella sorveglia il sistema ogni 2 minuti: server, rete, errori di Windows, salute dei dischi. Se qualcosa non va avvisa su Telegram e, solo nei casi decisi prima e con un tetto, rimedia da sola, per esempio riavviando il server se nessuno sta guardando. Un modello linguistico non decide niente: classifica gli errori mai visti e scrive il rapporto del mattino.
  • Fa il backup ogni giorno dei dati del server su un altro computer.

Cosa può diventare

  • La piattaforma di una famiglia, che smette di pagare abbonamenti per guardare quello che già possiede, e lo ritrova ordinato su ogni schermo di casa.
  • L’archivio video di un’associazione, una scuola o un’azienda: corsi, video di formazione, riprese di eventi e partite, consultabili con utenti e profili, senza caricarli su piattaforme esterne. I file non escono mai dal proprio computer.
  • Un prodotto col proprio marchio: nome, logo e colori dell’app scelti da chi lo usa, su un hardware economico, senza costi mensili.
  • È fatto a moduli: nuove sezioni, nuovi tipi di contenuto o nuovi dispositivi si aggiungono senza rifare il resto.

Com’è fatto

  • Streaming con richieste a intervalli (HTTP Range): il video si sposta avanti e indietro senza scaricarlo tutto.
  • Coda di conversione con FFmpeg e accelerazione hardware Intel (Quick Sync), con stima del tempo rimanente.
  • Accesso da fuori tramite un tunnel Cloudflare, senza aprire porte sul router, con utenti, inviti e accesso a token.
  • Database SQLite in modalità WAL, perché letture e scritture contemporanee non si blocchino a vicenda.

Schermate

Il manager desktop, con lo strumento di rinomina dei file
Il manager desktop, con lo strumento di rinomina dei file

Vuoi provare le mie app Android prima che escano? Diventa tester