Teletext subtitles of a broadcast channel¶
Half of the channels on European satellite and cable carry teletext, and their subtitles live on one of its pages — usually 888. A TV set decodes that page itself and puts the lines over the picture. A subscriber watching the same channel in your app gets nothing: no OTT player has ever decoded teletext.
Catena decodes the subtitle pages and serves each one as a separate WebVTT track that every player understands. Nothing has to be added to the channel: the text comes from the very signal you already receive.
For captions embedded in the picture itself (CEA-608/708, the American way of doing the same thing) see Closed captions.
Why a provider needs it¶
- Subtitles stop getting lost on the way to the subscriber. The broadcaster delivered them, your player failed to show them — and the complaint lands on you, not on the broadcaster.
- Accessibility requirements. The European Accessibility Act asks for subtitles to be preserved when broadcast material is distributed online. The practical meaning is simple: if the subtitles were on air, they must be in the app too.
- Multiple languages for free. A broadcaster often puts several subtitle pages into one channel — one per language. Each becomes its own subtitle menu entry, with no second input and no manual work.
- One input, every output. Decode once on ingest, deliver to the browser, to the app and to the TV set alike.
Enabling extraction¶
Extraction is off by default and has to be asked for per channel. Open the stream, the Process tab, the Teletext section, and pick the mode:
- Pass through inside MPEG-TS (no subtitle track) — the default. Teletext travels on to MPEG-TS consumers untouched, and nothing is decoded.
- Extract subtitle pages into tracks — every subtitle page becomes a WebVTT track. Teletext keeps travelling inside MPEG-TS as well: extraction adds a track, it does not take one away.
Below the selector, Catena shows the subtitle pages known from the source. See setting the language.
Extraction costs the channel low latency
A subtitle cue is only known when it ends: until the page changes, the line still stands on screen and its duration is not decided. At the low-latency live edge the text therefore does not exist yet, and a player standing there would never see a subtitle at all. That is why a channel with a text track is served without LL-HLS parts — ordinary HLS and DASH segments, with their usual few seconds of delay.
This is also why extraction is not switched on automatically for every channel carrying a teletext PID: a channel you only pass through has no reason to pay that price.
What the subscriber sees¶
The player gets an ordinary subtitle menu: one entry per subtitle page, with its language. The text follows the speech and sits where it sat on air.
Subtitles work in the archive too, so a recorded programme keeps them. Extraction has to be on at the time of recording, though: what was not decoded on ingest cannot be recovered from the archive afterwards.
Set the subtitle language¶
You need permission to edit the stream configuration. The source may signal the wrong language for a teletext page or omit it. In the stream configuration, you can set the language of the extracted subtitle track separately for each page. This changes the language signalled to the player; it does not translate the text.
- Open a running stream and select the Processing tab. In Teletext, select Extract subtitle pages into tracks.
- In the row for the page, enter an ISO 639 code such as
rusorengin Subtitle track language. If the source language is unknown, Page language showsund. - Click Save. Open the stream in a player and check that the subtitle track has the intended language.

By default, the source language is used. In the screenshot, the source signals eng for page 888, and the operator has set rus. To use the source language again, clear Subtitle track language and save.
The table shows known subtitle pages. If it says “no text data received yet”, no non-empty text has yet been observed for that declared page.
If there are no subtitles¶
- No teletext subtitle pages are found. Check that the stream is running and the source carries subtitle pages.
- A page is listed but the player has no track. Select page extraction and save the setting.
- The track has no text. Check it while someone is speaking. If text is still missing, send a stream sample to support.
- The language in the player is wrong. Check the code in Subtitle track language and correct it if necessary.
- Latency increased after extraction was enabled. Teletext extraction disables LL-HLS parts, as described above.