ISTRUZIONI E INFORMAZIONI RAIWIN
 
In questa cartella e' presente un file RaiWin.bat eseguibile. Il file .bat puo' essere modificato con un editor di testo.
RaiWin funziona con le versioni sia a 32 che a 64bit di Windows XP, Vista,7, 8,10 e 11.

Con Windows 11 versione PRO e non HOME, potrebbe essere' necessario ripristinare la 'console host' prima di lanciare il file batch, per visualizzarlo correttamente. Per farlo, andare sulla icona start poi scegliere-->impostazioni-->privacy e sicurezza-->per sviluppatori e sotto la voce 'terminale' scegliere 'windows console host' (per ripristinare la scelta di default scegliere invece 'lascia la scelta a windows).

RaiWin permette la visione dei contenuti del sito web RAIPlay della RAI. E' possibile vedere i programmi TV e Radio in diretta,i programmi in Replay ed i VOD. Non e' possibile vedere il canale 4k 'Rai 4k' quando presente nel menu principale.
E' possibile effettuare anche il restreaming del video su altro dispositivo su rete locale (opzione 14 del menu principale).
Caratteristica importante dell'applicativo e' che i programmi TV e Radio possono essere registrati oltreche' visti. Si ricorda comunque che la registrazione  e' responsabilita' 
esclusiva dell'utilizzatore finale e deve essere usata solamente per motivi personali di studio, senza ledere in qualsiasi modo i diritti RAI. Con l'opzione 13) e' inoltre possibile effettuare una ricerca per parole chiave dei programmi. Le parole verranno ricercate sia sui titoli dei programmi disponibili che sul riassunto del programma stesso presente nelle pagine del sito web di RAI Replay. 
 
L'uso dell'applicativo e' semplice. Una volta estratto il file compresso .zip copiare la cartella RaiWin in una qualsiasi directory del vostro computer (ad esempio cartella Video). La qualita' e la riproduzione dei video  e' ovviamente condizionata dalla velocita' di connessione a  disposizione. 

Per funzionare al meglio richiede alcuni applicativi e mediaplayer. ATTENZIONE! Alcuni di questi applicativi come VLC, MPV o SMPlayer sono forniti anche dall'app Microsoft Store.
Non installarli dallo Store, altrimenti RaiWin non sara'in grado di trovarli. Infatti Windows installa gli applicativi forniti dallo Store in una directory dedicata e non accessibile.
 
VLC e' obbligatorio per lanciare il restreaming come spiegato dopo. VLC ha due versioni: 32bit e 64bit. Il programma comunque trovera' in automatico se VLC e' stato installato e il path per lanciarlo, a patto che sia stato installato nelle directory canoniche di Windows per i programmi: C:\Program Files o C:\Program Files (x86). 
Per fare il restreaming e per la registrazione di alcuni canali VOD si consiglia vivamente l'installazione anche di 'FFMPEG', sebbene RaiWin usi di default il tool HLSDL fornito gia' nel file .zip. ma che potrebbe non funzionare talora nel restreaming e nella registrazione.

Per installare FFMPEG:

A) modo piu' semplice: installare il tool 'Streamlink' (scelta consigliata) che a sua volta installa anche 'ffmpeg'. Scaricare la versione Windows file .exe e scegliere
d'installare nella directory di default. Il link per il download e': https://github.com/streamlink/windows-builds/releases. Potrebbero apparire dei warning durante il download ma proseguire.

B) installare QMPlay2, KMPlayer o Serviio che ugualmente forniscono anche 'ffmpeg'. 

C) procedura un po' complicata (sconsigliata ai meno esperti): https://www.computermania.org/tutorial/informatica/come-installare-ffmpeg-su-windows-10 

Come player si consiglia MPV, Per installarlo:

A) Scaricare SMPlayer che fornisce insieme anche MPV da: https://www.smplayer.info/en/downloads

B) da https://mpv.io/installation/ --> scaricare le 'windows build')- versione 32 o 64bit. Il programma non ha un installer per Windows ma una volta scaricato, si scompatta direttamente e rinominata la cartella 'mpv', la si mette nella directory C:\Program Files (x86) o C:\Program Files


Altri Player consigliati:

1) MPV.NET che si basa su MPV (https://github.com/stax76/mpv.net/releases) ma e' facile da installare

2) SMPlayer (https://www.smplayer.info/en/downloads) versione 32 o 64bit (fornisce anche MPV)

3) QMPLayer2 (https://github.com/zaps166/QMPlay2 e andare sotto 'Installation -> download windows installer) versione 32 o 64bit 

4) KMPLAYER ( http://kmplayer.com/ --> selezionare lingua inglese del sito e installare solo la versione 64bit 

5) MEDIA PLAYER CLASSIC in download qui: https://media-player-classic-home-cinema.it.uptodown.com/windows

 
La scelta tra i player e' soggettiva, tenendo conto che: 
- MPV in genere non da problemi 
- SMPlayer controllare che abbia il motore multimediale 'mpv' sotto preferenze->opzioni->generale e sotto opzioni->preferenze->Rete->Supporto siti video-->mpv + youtube.dl 
- QMPlay2 permette di scegliere la risoluzione durante la visione ma puo' dare qualche problema di riproduzione 
- MPV.NET e' basato su MPV con medesime caratteristiche ma con un'interfaccia meno minimalistica (usare il tasto destro del mouse) ed ha un installer per Windows 
- KMPLAYER (solo versione 64bit) in genere non da problemi.  
- MEDIA PLAYER CLASSIC in genere non da problemi.

--------------------------------------------------------- 
Se non viene trovato al primo avvio nessuno dei player descritti, apparira' un messaggio d'avvertimento e verra' visualizzato un menu di scelta per il 
player. Sotto il menu principale con l'opzione 15) e' possibile modificare il player. Attenzione: In entrambi i  casi l'applicazione cerchera' il player solo nei percorsi canonici in cui Windows installa di default i programmi (cioe' 'Program Files' e 'Program Files (x86)'). 
Un messaggio conferma la presenza del player prescelto. Se il player e' in altri percorsi, verra' chiesto l'inserimento di un path personalizzato. Come recorder viene usato il tool hlsdl versione per Windows (www.https://github.com/selsta/hlsdl)  particolarmente leggero e  performante che registra sempre alla massima risoluzione possibile oppure secondo la scelta dell'utente.  
 
Per lanciare l'applicazione cliccare sul file 'RaiWin.bat'. Dal menu principale si passa ai menu specifici ed inserendo il numero del programma 
scelto s'accede alla visione. Se nelle opzioni in basso si sceglie "R) registra", l'applicativo si mette in modalita' record 'ON' e partira' la registrazione del programma. E' possibile anche selezionare la qualita' di registrazione. Una finestra viene aperta per il controllo del flusso di registrazione che si chiude automaticamente alla fine del programma. Se la finestra viene chiusa prima la registrazione si interrompe. Il file 
registrato (per i canali video in formato .mp4 e canali radio in formato .aac) viene scaricato nella sottocartella 'REC'. E' possibile anche creare una 'playlist' una volta scelto un programma. La playlist viene salvata come file di testo nella cartella EXE/LIST_M3U con il nome del programma e contenente i link ai video eseguibili con i player installati sul vostro computer. 

L'opzione 14 RESTREAMING  permette d'indirizzare il flusso video (o audio per le Radio) su altro dispositivo (PC, Tablet, SmartPhone, AndroidTV ecc.). I protocolli sono: http, rtmp, rtsp. 
Per http e' necessario avere VLC installato. Per usare i protocolli rtmp e rtsp bisogna prima avviare un server apposito. Consigliato l'uso di rtsp-simple-server versione (dalla 0.16 in poi) per Windows: https://github.com/aler9/rtsp-simple-server/releases.  Scompattare il file scaricato in C:\Program Files e lanciare il file rtsp-simple-server, abilitando il firewall. 
L'opzione 14 chiedera' poi quale protocollo usare tra HLSDL o FFMPEG. HLSDL e' ricompreso nel file .zip fornito, mentre FFMPEG deve essere installato come descritto prima. Con HLSDL come tool si sono manifestati problemi audio su alcuni video, nel caso installare e scegliere il restreaming con FFMPEG.
Una volta fatto questo si procede normalmente nella scelta del canale. Sara' poi sufficiente aprire sull'altro dispositivo in rete locale un mediaplayer (VLC, MPV ecc.) su queste porte e indirizzo locale
segnalato nella finestra del file batch: 

http = http://<local_address>:8535

rtmp = rtmp://<local_address>:1935/live

rtsp = rtsp://<local_address>:8554/live

Con SmartTV dove non sempre e' possibile usare un mediaplayer si puo' fare restreaming usando un media player configurato adeguatamente  (ad esempio: 'Serviio'). In tal caso e' preferibile usare il protocollo 'http'. In RaiWin si apre una nuova finestra dove il tool prescelto fara' il restreaming. Alla fine chiuderla e continuare premendo un tasto per tornare al menu iniziale.
Conviene provare le varie combinazioni tra protocolli e tool fino a trovare quello migliore per le proprie esigenze di rete. 

Si rilevano comunque questi problemi:
- alcuni titoli potrebbero non essere accessibili nonostante siano elencati. 
  In tal caso e' probabile che gli stessi non siano fruibili nemmeno sul sito web RAI;
- sporadicamente i server RAI manifestano temporanee interruzioni e il menu' appare vuoto;
  in tal caso basta riprovare dopo breve tempo. 
  
RaiWin.bat deriva da uno script per Linux e *Nix sviluppato da Shorewall e sotto licenza GPL nonche' dalla versione per Windows in porting a cura 
di @Panunzio scaricato dal sito di https://www.angels-of-fire.com/forumz/. Quest'ultimo e' stato poi riadattato da Shorewall e Bird52 per essere ancora 
piu' fruibile dall'utente, soprattutto per la parte riguardante la funzione di ricerca e la compatibilita' con le varie versioni di Windows.
 
Buona visione!  
 

