TroveRAI è uno strumento da riga di comando per consultare la programmazione TV della RAI.
Questo progetto nasce come esperimento di vibe coding: tutto il codice Python è stato prodotto interamente tramite Claude AI utilizzando Claude Code.
- Python >= 3.10
- Poetry (per la gestione delle dipendenze)
git clone https://github.com/gianluca-mascolo/troverai.git
cd troverai
poetry installNota: TroveRAI non richiede autenticazione. Le API del palinsesto RaiPlay sono pubbliche.
poetry run troverai --ora# Palinsesto di oggi
poetry run troverai --canale rai-1
# Palinsesto di domani
poetry run troverai --canale rai-2 --data domani
# Palinsesto serale (dalle 20:00)
poetry run troverai --canale rai-3 --dalle 20:00Mostra la programmazione serale (20:00-23:00) dei canali principali:
poetry run troverai --prima-seratapoetry run troverai --cerca "film"
poetry run troverai --cerca "TG" --data domaniÈ possibile filtrare i programmi per tipologia (--tipo) e/o genere (--genere):
# Solo film su Rai Movie
poetry run troverai --canale rai-movie --tipo Film
# Solo commedie
poetry run troverai --canale rai-movie --genere Commedia
# Film drammatici
poetry run troverai --canale rai-movie --tipo Film --genere Drammatico
# Film in onda adesso su tutti i canali
poetry run troverai --ora --tipo Film
# Film in prima serata
poetry run troverai --prima-serata --tipo FilmTipologie disponibili: Film, ProgrammiTv, SerieTV
Generi disponibili: Commedia, Drammatico, AzioneAvventura, Thriller, Fantascienza, Horror, Animazione, Documentario, e altri.
Nota: I filtri non sono case-sensitive (
filmeFilmsono equivalenti).
poetry run troverai --canali| Opzione | Abbreviazione | Descrizione |
|---|---|---|
--ora |
-o |
Mostra cosa è in onda adesso |
--canale NOME |
-c NOME |
Palinsesto di un canale specifico |
--canali |
Lista dei canali disponibili | |
--prima-serata |
-p |
Prima serata su Rai 1/2/3 |
--cerca TESTO |
-s TESTO |
Cerca un programma per nome |
--data DATA |
-d DATA |
Data (oggi/domani/ieri/dd-mm-yyyy) |
--dalle HH:MM |
Filtra programmi a partire da un orario | |
--alle HH:MM |
Filtra programmi fino a un orario | |
--tipo TIPO |
-t TIPO |
Filtra per tipologia (Film, ProgrammiTv, SerieTV) |
--genere GENERE |
-g GENERE |
Filtra per genere (Commedia, Drammatico, ecc.) |
--compatto |
Formato di output compatto | |
--json |
Output in formato JSON (dati API grezzi) |
oggi,today- data odiernadomani,tomorrow- giorno successivoieri,yesterday- giorno precedentedd-mm-yyyyodd/mm/yyyy- data specifica+1,-2- offset rispetto a oggi
Per disabilitare l'output colorato, imposta la variabile d'ambiente NO_COLOR:
NO_COLOR=1 poetry run troverai --oraCon il flag --json è possibile ottenere l'output in formato JSON, contenente i dati grezzi delle API RaiPlay senza alcuna semplificazione o filtro.
# Palinsesto completo in JSON
poetry run troverai --canale rai-1 --json
# Programmi in onda adesso in JSON
poetry run troverai --ora --json
# Lista canali in JSON
poetry run troverai --canali --json
# Ricerca in JSON
poetry run troverai --cerca "film" --jsonL'output JSON può essere elaborato con strumenti come jq:
# Estrai solo i nomi dei programmi in prima serata
poetry run troverai --prima-serata --json | jq '.. | .name? // empty' | head -10troverai/
├── src/troverai/ # Codice sorgente principale
│ ├── cli.py # Implementazione CLI
│ ├── __main__.py # Entry point per python -m
│ └── __init__.py # Metadata del package
├── SperimenteRAI/ # Script sperimentali (non necessari per il CLI)
├── pyproject.toml # Configurazione Poetry
└── README.md
Questo progetto è distribuito sotto licenza GPL-3.0-or-later.
Gianluca Mascolo