Archiv, Catch-up und Timeshift
Aktualisiert am 07 Okt 2026Castreon kann alles, was ein Kanal in den letzten Tagen gesendet hat, auf der Festplatte aufbewahren. Ihre Abonnenten sehen dann im IPTV-Player vergangene Sendungen (Catch-up), starten die laufende Sendung von vorn (Start-over) oder schauen den Kanal mit gewählter Verzögerung (Timeshift).
Verfügbar ab Castreon 1.0.8 in den Plänen Pro (bis zu 7 Tage pro Kanal) und Enterprise (ohne Tagesgrenze — die Grenze ist die Festplatte).
So funktioniert es
Der Kanal schreibt seinen HLS-Ausgang ohnehin in Segmenten von wenigen Sekunden. Das Archiv bewahrt diese Segmente auf der Festplatte auf, bevor sie das Live-Fenster verlassen — ohne zusätzliche Transcodierung und ohne neuen Prozess. Jedes Segment wird nach seiner Sendezeit abgelegt; das Archiv läuft daher sauber über Neustarts des Kanals oder des Servers hinweg.
Auf derselben Festplatte wird das Segment gar nicht kopiert (Hardlink); liegt das Live-HLS im Arbeitsspeicher (tmpfs), wird es auf die Festplatte kopiert.
Für einen Kanal einschalten
- Kanal öffnen → Bearbeiten.
- Unter Archiv (Catch-up) Archiv aufbewahren ankreuzen und die Anzahl der Tage wählen.
- Speichern.
Die Aufzeichnung beginnt nach wenigen Sekunden. Der Kanal braucht:
- einen HLS-Ausgang — er kann neben den anderen Ausgängen bestehen; ein Kanal ohne konfigurierten Ausgang hat ihn standardmäßig;
- TS-Segmente — am HLS-Ausgang den Container TS oder automatisch (automatisch wählt fMP4 nur, wenn das Profil HEVC oder AV1 codiert);
- unverschlüsseltes HLS — das Archiv bewahrt kein mit AES-128 verschlüsseltes HLS auf;
- Dauerbetrieb, nicht Auf Abruf — ein Kanal auf Abruf stoppt ohne Zuschauer und das Archiv hätte Lücken.
Das Panel sagt Ihnen vor dem Speichern, wenn etwas fehlt.
Schalten Sie das Archiv eines Kanals aus oder löschen Sie den Kanal, wird das Aufgezeichnete spätestens nach einer Minute von der Festplatte gelöscht.
Speicherplatz
Das Archiv belegt die Bitrate des Kanals mal die aufbewahrte Zeit:
| Bitrate des Kanals | Ein Tag | 7 Tage |
|---|---|---|
| 2 Mbit/s | ≈ 22 GB | ≈ 151 GB |
| 5 Mbit/s | ≈ 54 GB | ≈ 378 GB |
| 8 Mbit/s | ≈ 86 GB | ≈ 605 GB |
Bei einem Kanal mit mehreren Qualitäten (ABR) werden alle Qualitäten aufbewahrt, ihre Bitraten addieren sich also.
Unter Einstellungen → Archiv finden Sie:
- Archivordner — leer bedeutet
archiveim Datenordner des Knotens. Wir empfehlen eine separate, große Festplatte (kein tmpfs). Ein neuer Ordner wird beim Speichern angelegt und geprüft. Bereits Aufgezeichnetes wird nicht verschoben: es bleibt im alten Ordner. - Minimaler freier Platz (%) — standardmäßig 10 %. Fällt die Festplatte unter die Schwelle, löscht der Knoten die ältesten Stunden, von jedem Kanal, bis wieder Platz ist. Die Aufzeichnung stoppt nie, weil die Festplatte voll ist.
- die Festplatte (frei / gesamt), den Platz des Archivs, Ihren Plan und für jeden Kanal die Tage, den Platz, seit wann er ein Archiv hat und ob er gerade aufzeichnet.
Das Archiv wird stundenweise gelöscht: nach den Tagen jedes Kanals und nach der Schwelle für freien Platz.
In IPTV-Playern
Im Player muss nichts eingerichtet werden. M3U exportieren kennzeichnet die Kanäle mit Archiv:
#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 und die anderen Player, die Catch-up aus der M3U-Liste unterstützen, zeigen das Archiv am Kanal, und vergangene Sendungen im Programm lassen sich abspielen. Für die Sendungen nutzt der Player das TV-Programm — bei DVB-Kanälen kommt es direkt aus dem Mux, siehe TV-Programm (EPG) aus DVB. Die Liste fordert das Programm selbst über die Archivtage an (höchstens 8). Kanäle ohne DVB-Quelle brauchen ein XMLTV-Programm aus einer anderen Quelle, verknüpft über die EPG-ID.
Laden Sie die M3U-Liste im Player neu, nachdem Sie das Archiv eingeschaltet haben: die Catch-up-Attribute erscheinen nur in danach exportierten Listen.
Archivadressen
Sie liegen alle neben der Live-Adresse des Kanals, http://<öffentliche-domain>/live/<kanal>/, mit denselben Zugriffsregeln (Token, IP-Freigabeliste). <start> ist die UNIX-Zeit (UTC, in Sekunden), <dauer> ist in Sekunden.
| Adresse | Was Sie erhalten |
|---|---|
index-<start>-<dauer>.m3u8 |
eine Sendung (Catch-up) |
index-<start>-now.m3u8 |
von <start> bis live (Start-over) |
timeshift_abs-<start>.m3u8 |
dasselbe |
timeshift_rel-<sekunden>.m3u8 |
den Kanal so viele Sekunden zurück |
archive-<start>-<dauer>.ts |
eine Sendung als ein MPEG-TS-Stream (?download=1 lädt sie als Datei herunter) |
timeshift_abs-<start>.ts |
MPEG-TS ab <start>, weiter bis live |
Beispiel — eine Stunde ab 7. Oktober 2026, 18:00 UTC:
http://tv.ihre-domain.de:33400/live/canal-1/index-1791396000-3600.m3u8?token=…
- Bei einem Kanal mit mehreren Qualitäten ist die Playlist ein Master mit allen Qualitäten, wie live.
- Das Token aus der Adresse wird automatisch an jede Adresse in der Playlist angehängt.
- Eine Anfrage umfasst höchstens 24 Stunden; offene Playlists (Start-over, Timeshift) reichen höchstens 6 Stunden zurück.
Im Panel
Im Tab Programm des Kanals haben vergangene Sendungen, die im Archiv liegen, die Schaltfläche Abspielen, die laufende Sendung Von Anfang an. Der Player im Panel hat eine Zeitleiste — Sie können an jede Stelle der Sendung springen.
Metriken
/metrics enthält castreon_archive_bytes, castreon_archive_disk_free_bytes, castreon_archive_disk_total_bytes, castreon_archive_channels_recording und castreon_archive_pruned_hours_total — nützlich zum Beispiel für einen Grafana-Alarm, wenn die Archiv-Festplatte voll läuft. Siehe Metriken und Grafana.
Häufige Probleme
- Der Kanal zeichnet nicht auf (Einstellungen → Archiv): der Kanal muss laufen; steht in seiner Zeile eine Meldung, nennt sie den Grund (zum Beispiel verschlüsseltes HLS oder fMP4-Segmente).
- „not in archive“ (404): der angefragte Zeitraum liegt vor der ersten Aufzeichnung oder wurde bereits gelöscht (Tage des Kanals, minimaler freier Platz).
- Der Player zeigt das Archiv nicht: laden Sie die M3U-Liste und das TV-Programm im Player neu.
- „der Pro-Plan bewahrt das Archiv höchstens 7 Tage auf“: für mehr Tage ist der Plan Enterprise nötig.