RaiNix: uno script per vedere le trasmissioni RAI senza browser su Linux

RaiNixV3 è’ un agile script (licenza GPL) dello stesso autore del vecchio plugin su browser Firefox gentilmente offerto ed ospitato in download qui. Permette la visione/registrazione ed il restreaming dei programmi RAI (comprese le Radio) e di RAI Replay senza l'uso del browser, evitando la pubblicità iniziale e senza registrazione per l'accesso a Rai Replay e OnDemand. Con l'opzione del menu principale 'Rai Play Vods' si scarica in automatico anche l'altro script 'RaiNixVod' per vedere/registrare e mettere in restreaming i programmi OnDemand della RAI. Lo script funziona, con opportuni accorgimenti, anche su FreeBSD. Per gli utenti Windows e Apple MacOS sono disponibili in download apposite versioni ( 'RaiWin' e 'RaiMac') che hanno funzionalità analoghe allo script per Linux come spiegato dopo nell'articolo. A causa dei continui cambiamenti RAI, lo script necessita di frequenti aggiornamenti. Pertanto, è gradita qualsiasi segnalazione. La versione 'RaINixV3' (versione patchata 3.2.1 dell'8 febbraio 2021) ) è in download cliccando qui  oppure andando nell’apposita sezione 'DOWNLOAD' di questo sito.

COME USARE RAINIXV3

Dipende da curl, wget, dialog, ffmpeg, youtube-dl (facoltativo) e jq. Il tool jq (preferibilmente dalla versione 1.5) si è reso necessario dato l'ampio uso della RAI del formato json. Supporta un'ampia scelta di player multimediali:  mpv, SMplayer (con mpv settato a player di default), QMPlay2, VLC, parole, Bomi Player. Per le registrazioni di default lo script usa il tool 'selsta/hlsdl' su Linux e su Windows (ambiente WSL), di cui è disponibile in download un binario eseguibile già pronto in un file .zip (leggere il README per le istruzioni) hlsdl.zip per Linux. Comunque, se non installato, viene usato automaticamente ffmpeg.

Una volta scaricato lo script, eventualmente renderlo eseguibile e poi lanciarlo da terminale con il comando ./rainixv3.sh. Con bash -x rainixv3.sh è possibile attivare il debug. Si sceglie dal menu quello che si vuole riprodurre e una volta scelto il canale/programma si opta per la riproduzione oppure per registrare e fare il restreaming si sceglie l'opzione apposita.

Il menu iniziale dispone inoltre dell'opzione 'Cineteca Rai movie' che permette di scorrere i generi ed i titoli dei film accessibili su Rai Movie, rendendo il canale più fruibile per l'utente. In basso l'utile funzione di ricerca 'Rai Search' che permette di ricercare il video o la trasmissione che interessa mediante l'inserimento di parole-chiave. Inoltre con la la funzione di ricerca, inserendo una parola significativa più 'film', potrete cercare anche l'opera cinematografica relativa sul canale RaiMovie. E' inoltre possibile configurare la risoluzione dei video e attivare anche la risoluzione per la registrazione con le apposite opzioni del menu principale.

COME REGISTRARE

ATTENZIONE!: si ricorda che l'uso di questa funzionalita' dei flussi sia di RaiNixV3 che di altri noti strumenti è responsabilità esclusiva dell'utilizzatore finale e deve essere usata solamente per motivi personali di studio, senza ledere i diritti Rai.
Si può registrare usando direttamente l’opzione 'Record' oppure durante la visione, ridando il focus sulla finestra dove c'è il menu con i programmi e poi di nuovo con 'Record'. E' possibile registrare e contemporaneamente vedere la trasmissione o vederne un'altra. Questa opzione è attivata nello script nella riga 'Multiprocess=1', settando a '0' il valore si ritorna ad un singolo uso. La registrazione viene archiviata di default nella cartella 'Video' della directory utente. Usando la funzione di ricerca, lo script chiede se si desidera registrare oppure vedere. Infine è stata introdotta la possibilità di escludere la finestra Xterm di controllo del flusso di registrazione (cambiare in HideRecorder="1”). Se VLC ha difficoltà a riprodurre registrazioni in formato AVI settare LiveRecFmt="mkv".  Con Windows Media Player su Windows settare su 'mkv' o 'avi'. Con l'opzione apposita nel menu principale è possibile attivare il controllo della risoluzione in registrazione.

COME FARE IL RESTREAMING

Una volta scelto un canale/programma è possibile avviare un restreaming locale dello stesso. L'opzione reindirizza il flusso anziche' sul default player verso l'indirizzo locale del PC dove lo script e' attivo. Il protocollo usato di default è 'http' con porta 8530. In alternativa si possono usare sia il protocollo rtp all'indirizzo rtp://239.101.101.1:1234 che il protocollo rtsp all'indirizzo 192.168.xx.xx:8554/live. Con rtsp si deve usare un server rtsp (ad esempio rtsp-simple-server). Lo script con il protocollo 'http' troverà, di norma, in automatico l'indirizzo IP (ad esempio: 192.168.x.x) del computer host (sempre che non siano presenti interfacce virtuali, bridges, vbox etc etc). Con l'avvio del restreaming appare prima una finestra terminale con il tool scelto in esecuzione (ffmpeg di default ma modificabile con hlsdl), mentre dopo qualche secondo apparirà anche una piccola finestra di monitor senz'audio. Per questa funzione il default è ffplay, ma è modificabile anch'esso. In questa maniera un qualsiasi altro dispositivo (smartphone, tablet, AndroidTV ecc.) collegato sulla rete locale può riprodurre il flusso direttamente collegandosi agli indirizzi citati con un media player in grado di gestire flussi di rete 'mpegts' (ad esempio VLC/MPV o altre app per Android e iOS). I dispositivi che non hanno a disposizione questo tipo di player  ma che siano in grado di usare il protocollo standard DLNA possono usare come middleware un mediaserver (consigliati Serviio o Jellyfin) in grado di gestire come input flussi di rete e permettere alla TV, via DLNA/uPnP, di riprodurre il contenuto. Il tutto senza ricorrere a protocolli proprietari del tipo Chromecast o SmartShare. In genere il  local restreaming e' risultato piu' efficiente usando come tool hlsdl anziche' ffmpeg. Il tool hlsdl è però utilizzabile solo con il protocollo 'http'.

COME CONFIGURARE

Entrambi gli  script sono facilmente configurabili intervenendo in alcune righe di codice situate nella parte iniziale. Queste le principali modifiche possibili (fare attenzione anche ai commenti inseriti a lato):

a) modificare l’ordine dei player per i canali TV e per le Radio nella riga 'PlayersLive= e PlayersRadio=;

b) Recorder= modifica l'ordine dei recorder (hlsdl, ffmpeg o youtube-dl);
c) con HideRecorder="1” scompare la finestra Xterm che controlla il flusso di registrazione. In tal caso non si ha a schermo il controllo del flusso ed anche un eventuale stop va fatto con riga di comando;
d) con NoTerm=0 si ripristina eventualmente la finestra Xterm anche durante la visione dei video;
e) con Wsl=1 (solo per Windows) si modifica il comportamento dello script in altri ambienti (modificare solo se ci sono problemi nell’uso);
f) con AudioCodec="libmp3lame" si cambia l’output del formato audio delle registrazioni in mp3, utile per problemi di compatibilità;
g) con LiveRecFmt= si cambia formato per il contenitore della registrazione delle dirette (usare 'avi', 'mkv' 'mp4') ed è utile per problemi di compatibilità con VLC, devices Apple iOS ed altro;

h) con ReplRecFmt= si cambia formato contenitore delle registrazioni per Rai Replay (usare 'avi', 'mkv' o 'mp4) utile per problemi di compatibilità come punto h);

i)   con Savedir= si cambia la directory dove scaricare le registrazioni (default: /<directory home utente>/Video);

l) con ResLive= si cambia il tool usato per il restreaming (0=ffmpeg 1=hlsdl);

m)  con ResProtocols=  si modifica l'ordine del protocollo usato per il restreaming ('http' di default oppure rtp o rtsp);

n)  con MonPlayers=  si modifica l'ordine del player usato come 'monitor' durante il restreaming (ffplay di default).

RAINIXV3 CON ALTRI SISTEMI OPERATIVI OLTRE LINUX

A)  Versioni a 32 o 64 bit di Windows  XP, Vista, 7, 8 e 10  possono usare un file batch RaiWin.bat che ha funzionalità analoghe a RaiNixV3. Scaricare da qui il file.zip, scompattare e lanciare, dopo aver attentamente letto il file README, il programma eseguibile RaiWin. Deriva inizialmente da una versione in porting per Windows a cura di @Panunzio poi riadattata da Shorewall e Bird52. Questa versione per Windows non supporta però il restreaming (almeno per ora ). Solo con Windows 10 a 64bit potrete usare l’ambiente WSL (Windows Subsystem Linux) dove lo script funziona normalmente  a patto che sulla Linux caricata in WSL ci siano installate le dipendenze e gli applicativi richiesti. Per installare e gestire un ambiente WSL leggere questo articolo.

B) Apple MacOS può usare una versione appositamente modificata per MacOS versioni 10.11 e superiori. Scaricare da qui il file .zip, scompattare e leggere attentamente il file README per l'uso in ambiente MacOS.

C) FreeBSD e derivate se lo script non parte, va lanciato con bash rainixv3.sh. Per registrare con FreeBSD cambiare eventualmente l'ordine dei recorder nella riga 'Recorders=' mettendo ffmpeg o youtube-dl al primo posto (hlsdl non è disponibile).

PROBLEMI NOTI (ISSUES)

RaiNixV3 è stato testato nei seguenti ambienti Linux (Fedora 31/33 workstation, Ubuntu 18.04 LTS e 20.04, Mageia 5 e seguenti, Slackware 14.2, Manjaro/ArchLinux rolling release, MX-19  Linux/Debian Buster e Debian Bullseye). Inoltre funziona come già detto su FreeBSD (dalla 10 in poi), Windows 10 (in ambiente WSL) e MacOS (versioni 10.11 e seguenti). L'utente 'Mitm' ha inoltre gentilmente segnalato che lo script è in grado di girare su un Raspberry con sistema operativo Raspbian.

Lo script agisce solamente estraendo i link dalle pagine del sito RAI limitandosi a passarli al player/recorder impostato dall'utente. Pertanto:
- Non esegue nessuna manipolazione sul flusso, per cui problematiche di riproduzione (ad esempio buffering) sono da addebitarsi unicamente all'associazione Player/Linea/Server Rai. Va quindi verificata con uno speed test la banda utilizzabile dal computer;

- Se un video non si carica con messaggi di 'non trovato' ecc. è probabile che quel video non sia disponibile sul sito della RAI nonostante risulti nell'elenco;

- Nel caso di problemi di banda si può tentare con il player QMPlay2 che permette la modifica VBR per i flussi hls RAI agendo sulle opzioni di settings del player stesso. Però, con risoluzioni più basse, alcuni streaming potrebbero non partire perchè non disponibili sui server RAI.

- Se con ffmpeg si notano asincronie a/v e' preferibile usare hlsdl oppure youtube-dl per registrare. A volte puo' essere utile cambiare anche il formato di output (avi/mkv/mp4) rispetto ai default;

- Nel menu' di RAI Replay sono omesse alcune entrate (RaiNews 24, Rai Scuola, Rai Sport) per il semplice motivo che anche usando il browser risultano quasi prive di contenuti.

- se durante il restreaming con protocollo http appaiono più indirizzi è probabile che abbiate più interfaccia di rete attive (ad esempio eth0 e virbr0). Controllate con ifconfig da terminale. In tal caso nello script provate a decommentare la riga con LocalIp=$(ip addr...) e commentare quella con LocalIp=$(ip route...). Oppure usate il protocollo rtp.

- Il protocollo 'rtp' per il restreaming può non funzionare. Il problema potrebbe verificarsi con alcuni modem-router in comodato d'uso di alcuni provider. In tal caso usare il protocollo 'http' di default oppure rtsp (quest'ultimo avviando un rtsp server come rtsp-simple-server).

- (solo FreeBSD e derivate) qualora ffmpeg abbia problemi può rendersi necessario compilarlo dai ports con l'opzione SDL e X264 abilitate. La compilazione fornirà anche il player 'ffplay' che nei pacchetti binari non è disponibile.