Archivio, catch-up e timeshift
Aggiornato il 07 ott 2026Castreon può conservare su disco tutto ciò che un canale ha trasmesso negli ultimi giorni. I vostri abbonati possono così vedere nel player IPTV i programmi passati (catch-up), far ripartire dall'inizio il programma in corso (start-over) o guardare il canale con un ritardo a scelta (timeshift).
Disponibile da Castreon 1.0.8, nei piani Pro (fino a 7 giorni per canale) ed Enterprise (senza limite di giorni — il limite è il disco).
Come funziona
Il canale scrive comunque l'uscita HLS in segmenti di pochi secondi. L'archivio conserva questi segmenti su disco prima che escano dalla finestra live — senza alcuna transcodifica aggiuntiva e senza un nuovo processo. Ogni segmento viene conservato in base all'ora in cui è stato trasmesso, così l'archivio prosegue senza problemi anche dopo i riavvii del canale o del server.
Sullo stesso disco il segmento non viene copiato affatto (hard link); se l'HLS live è in memoria (tmpfs), il segmento viene copiato su disco.
Attivazione su un canale
- Aprite il canale → Modifica.
- In Archivio (catch-up), spuntate Conserva l'archivio e scegliete quanti giorni.
- Salva.
La registrazione inizia in pochi secondi. Il canale ha bisogno di:
- un'uscita HLS — può stare accanto alle altre uscite; un canale senza uscite configurate la ha per impostazione predefinita;
- segmenti TS — sull'uscita HLS, il contenitore TS o automatico (automatico sceglie fMP4 solo quando il profilo codifica in HEVC o AV1);
- HLS non cifrato — l'archivio non conserva HLS cifrato AES-128;
- funzionare sempre, non Su richiesta — un canale su richiesta si ferma senza spettatori e l'archivio avrebbe buchi.
Il pannello vi avvisa prima del salvataggio se manca qualcosa.
Se disattivate l'archivio di un canale o cancellate il canale, quanto registrato per esso viene cancellato dal disco entro un minuto.
Spazio su disco
L'archivio occupa il bitrate del canale moltiplicato per il tempo conservato:
| Bitrate del canale | Un giorno | 7 giorni |
|---|---|---|
| 2 Mbit/s | ≈ 22 GB | ≈ 151 GB |
| 5 Mbit/s | ≈ 54 GB | ≈ 378 GB |
| 8 Mbit/s | ≈ 86 GB | ≈ 605 GB |
Per un canale con più qualità (ABR) vengono conservate tutte le qualità, quindi i loro bitrate si sommano.
In Impostazioni → Archivio trovate:
- Cartella dell'archivio — vuoto significa
archivenella cartella dati del nodo. Consigliamo un disco separato e capiente (non tmpfs). Una nuova cartella viene creata e verificata al salvataggio. Quanto già registrato non viene spostato: resta nella vecchia cartella. - Spazio libero minimo (%) — 10 % per impostazione predefinita. Quando il disco scende sotto la soglia, il nodo cancella le ore più vecchie, di qualsiasi canale, finché non torna spazio. La registrazione non si ferma mai perché il disco è pieno.
- il disco (libero / totale), lo spazio occupato dall'archivio, il vostro piano e, per ogni canale, i giorni, lo spazio, da quando ha un archivio e se sta registrando ora.
L'archivio viene cancellato a ore intere: secondo i giorni di ogni canale e secondo la soglia di spazio libero.
Nei player IPTV
Nel player non serve configurare nulla. Esporta M3U contrassegna i canali con archivio:
#EXTINF:-1 tvg-id="canal-1" catchup="default" catchup-days="7" catchup-source="http://…/live/canal-1/index-{utc}-{duration}.m3u8",Canal 1
TiviMate, OTT Navigator, Kodi (IPTV Simple), Televizo e gli altri player che supportano il catch-up dalla lista M3U mostrano l'archivio sul canale, e i programmi passati del palinsesto si possono riprodurre. Per i programmi il player usa il palinsesto TV — per i canali DVB arriva direttamente dal mux, vedete Palinsesto TV (EPG) da DVB. La lista richiede da sola il palinsesto sui giorni dell'archivio (al massimo 8). I canali che non sono DVB hanno bisogno di un palinsesto XMLTV da un'altra fonte, collegato tramite l'ID EPG.
Ricaricate la lista M3U nel player dopo aver attivato l'archivio: gli attributi di catch-up compaiono solo nelle liste esportate dopo.
Indirizzi dell'archivio
Stanno tutti accanto all'indirizzo live del canale, http://<dominio-pubblico>/live/<canale>/, con le stesse regole di accesso (token, IP consentiti). <inizio> è l'ora UNIX (UTC, in secondi), <durata> è in secondi.
| Indirizzo | Cosa ottenete |
|---|---|
index-<inizio>-<durata>.m3u8 |
un programma (catch-up) |
index-<inizio>-now.m3u8 |
da <inizio> fino al live (start-over) |
timeshift_abs-<inizio>.m3u8 |
lo stesso |
timeshift_rel-<secondi>.m3u8 |
il canale indietro di tanti secondi |
archive-<inizio>-<durata>.ts |
un programma come unico flusso MPEG-TS (?download=1 lo scarica come file) |
timeshift_abs-<inizio>.ts |
MPEG-TS da <inizio>, che prosegue fino al live |
Esempio — un'ora a partire dal 7 ottobre 2026, 18:00 UTC:
http://tv.vostrodominio.it:33400/live/canal-1/index-1791396000-3600.m3u8?token=…
- Per un canale con più qualità, la playlist è un master con tutte le qualità, come per il live.
- Il token dell'indirizzo viene aggiunto automaticamente a ogni indirizzo della playlist.
- Una richiesta copre al massimo 24 ore; le playlist aperte (start-over, timeshift) risalgono al massimo di 6 ore.
Nel pannello
Nella scheda Palinsesto del canale, i programmi passati presenti nell'archivio hanno il pulsante Riproduci e il programma in corso ha Dall'inizio. Il player del pannello ha una barra del tempo, quindi potete saltare in qualsiasi punto del programma.
Metriche
/metrics contiene castreon_archive_bytes, castreon_archive_disk_free_bytes, castreon_archive_disk_total_bytes, castreon_archive_channels_recording e castreon_archive_pruned_hours_total — utili, ad esempio, per un avviso in Grafana quando il disco dell'archivio si riempie. Vedete Metriche e Grafana.
Problemi frequenti
- Il canale non registra (Impostazioni → Archivio): il canale deve essere in funzione; se sulla sua riga compare un messaggio, indica il motivo (ad esempio HLS cifrato o segmenti fMP4).
- «not in archive» (404): l'intervallo richiesto è precedente alla prima registrazione o è già stato cancellato (giorni del canale, spazio libero minimo).
- Il player non mostra l'archivio: ricaricate la lista M3U e il palinsesto TV nel player.
- «il piano Pro conserva l'archivio al massimo 7 giorni»: per più giorni serve il piano Enterprise.