Channel EPG
An EPG (electronic program guide) is the schedule of what plays on a channel and when. You give a channel its EPG by uploading an XMLTV file. Each program in the file gets a title, an optional description, and a start and end time.
Before you start, you need:
- A Live or VOD2Live channel. See Live Channels.
- An XMLTV file (
.xml, up to 20 MB) with programs that haven’t ended yet. See the XMLTV File Reference for what the file can contain.
Which channels have an EPG
Section titled “Which channels have an EPG”The EPG tab is in the sidebar of Live and VOD2Live channels. Radio channels and live events don’t have it.
Upload an EPG file
Section titled “Upload an EPG file”-
Go to Media Catalog → Channels.
-
Click the channel in the table to open its sidebar.
-
Open the EPG tab.
-
Click the upload area that says Click or drag an XMLTV file to upload, and choose your
.xmlfile. You can also drag the file onto the area. -
If the channel already has programs that haven’t ended, Vidori asks Replace the schedule? Click Replace to continue, or Cancel to keep the current schedule. See What a new upload replaces.
-
Wait while the tab shows Uploading… and then Importing….
-
If the file has programs for several channels, Vidori asks
<file name>has programs for several channels. Which one is this channel? Select the channel and click Import. Each choice shows the channel’s name and itsidfrom the file, for exampleExample News (example-news). Click Cancel to stop without importing.
When the import is done, the tab shows the result.
The result
Section titled “The result”A green box titled Imported <file name> shows what happened:
N created, N skipped, N trimmed: the number of programs imported, skipped and shortened. See Skipped and trimmed programs for the reasons.- Schedule covers up to: when the last imported program ends.
- Warnings, one per line. There are four kinds:
| Warning | What it means |
|---|---|
N programs had no time zone and were read as UTC | A start or stop time has no offset such as +0100. Vidori read it as UTC. If your times are in another zone, the schedule is off by that difference: add the offset to the file and upload it again. |
N programs overlapped the next one and were shortened | A program ended after the next one started, so it was shortened to end where the next one starts. |
N programs started before the end of the programs already aired and were shortened | A program started before the last program that has already ended on this channel, so its start was moved to that end. |
N programs were skipped: … | Vidori couldn’t import some programs. The warning lists how many there were for each reason, for example 2 programs were skipped: 1 with no title, 1 with no end time. |
A warning for exactly one program uses the singular, for example 1 program was skipped: 1 with no title. The reasons are explained in the XMLTV File Reference.
Programs that have already ended are left out of the import without a warning.
Check the status of a channel’s EPG
Section titled “Check the status of a channel’s EPG”After the first upload, the EPG tab shows a summary of the channel’s schedule. Times are shown in your account’s time zone (Settings → General → Timezone), with the name of the zone after the time.
| Field | What it shows |
|---|---|
| Last upload | When the last successful upload was imported. |
| Programs that haven’t ended | How many programs are on air now or still to come. |
| Schedule covers up to | When the last of those programs ends, or — when there are none. |
| XMLTV channel id | The channel id in the file that the programs came from. Vidori uses it again for the next upload when the new file has the same id. |
Until a file has been uploaded, the tab shows No EPG uploaded.
When the last program ends within 24 hours, the tab warns you so you can upload a new file in time: The schedule runs out in less than 24 hours (<date and time>). Upload a new EPG file. If the tab stays open past that time, the warning changes to The schedule has run out (<date and time>). Upload a new EPG file.
Once every program has ended, Programs that haven’t ended shows 0 and Schedule covers up to shows —. Upload a new file to give the channel a schedule again.
What a new upload replaces
Section titled “What a new upload replaces”Each upload replaces the programs that haven’t ended yet, including the program that is on air now. Programs that have ended stay, so what already aired is kept. Vidori deletes a program 7 days after it ends.
The old schedule is only replaced when the new file imports. If the file is rejected, the channel keeps the schedule it had.
Programs from an upload belong to the channel’s EPG. They don’t appear as assets in your media catalog.
Where viewers see the schedule
Section titled “Where viewers see the schedule”Viewers see a channel’s programs in the channel guide (the Live TV screen) of your apps.
Parental controls
Section titled “Parental controls”Programs from an XMLTV upload carry no age rating: Vidori doesn’t read the <rating> element in the file. When you turn on parental controls (Settings → Parental Controls), content with no age rating is hidden from viewers who have an age limit, so these viewers don’t see the channel’s programs. This includes anonymous viewers when you’ve set a Default Rating. Viewers without an age limit see the programs as usual.
Troubleshooting
Section titled “Troubleshooting”Errors appear in a red box in the EPG tab. After an error, fix the cause and choose the file again.
”<file name> isn’t an XMLTV file. Choose an .xml file.”
Section titled “”<file name> isn’t an XMLTV file. Choose an .xml file.””The file name doesn’t end in .xml. Nothing was uploaded. Choose an XMLTV file with the .xml extension.
”<file name> is larger than 20 MB, the limit for an EPG file.”
Section titled “”<file name> is larger than 20 MB, the limit for an EPG file.””The file is over 20 MB. Nothing was uploaded. Split it so that it only holds the channel and the days you need, or remove the elements Vidori doesn’t read (see What Vidori ignores).
”Storage limit exceeded (<percent>% used). Please upgrade your plan or delete unused content.”
Section titled “”Storage limit exceeded (<percent>% used). Please upgrade your plan or delete unused content.””Your account has no storage left, so the upload didn’t start. Click Upgrade next to the message to open your subscription, or delete content you don’t need and try again. See Subscription Management.
”The upload couldn’t start (HTTP <status>).”
Section titled “”The upload couldn’t start (HTTP <status>).””Vidori couldn’t get a place to store the file. Try again in a few minutes. If the message keeps appearing, contact support.
”The upload failed (HTTP <status>). Try again.”
Section titled “”The upload failed (HTTP <status>). Try again.””Sending the file failed part of the way. Upload it again.
”The upload failed. Check your connection and try again.”
Section titled “”The upload failed. Check your connection and try again.””The connection dropped while the file was being sent. Check your connection and upload it again.
”This isn’t an XMLTV file: its root element is <name>, not <tv>”
Section titled “”This isn’t an XMLTV file: its root element is <name>, not <tv>””The first element of the file isn’t <tv>. You may have chosen the wrong file, or a web page or another format that was saved as .xml. Export the program guide from its source as XMLTV.
”The file isn’t valid XML (line N)”
Section titled “”The file isn’t valid XML (line N)””The file has a mistake in its XML, such as a tag that isn’t closed or a & that isn’t written as &. The line number, when shown, points to where Vidori stopped reading. Open the file in a text editor or an XML validator, fix that line and upload again.
”The file declares XML entities, which aren’t allowed”
Section titled “”The file declares XML entities, which aren’t allowed””The file defines its own XML entities, which Vidori doesn’t accept for safety. Remove the entity declarations. A <!DOCTYPE tv SYSTEM "xmltv.dtd"> line is fine to keep.
”The file declares a character encoding that isn’t supported”
Section titled “”The file declares a character encoding that isn’t supported””The <?xml … encoding="…"?> line at the top of the file names an encoding Vidori can’t read. Save the file as UTF-8 and use encoding="UTF-8" in that line.
”The file has no channels or programs”
Section titled “”The file has no channels or programs””The file has no <channel> elements and no <programme> elements with a channel attribute. Check that you exported the guide and not an empty file.
”The file has no programs for channel <channel id>”
Section titled “”The file has no programs for channel <channel id>””The channel is in the file but none of its <programme> elements name it in their channel attribute. Check that the channel attribute of the programs matches the id of the <channel>.
”Every program in the file for channel <channel id> has already ended”
Section titled “”Every program in the file for channel <channel id> has already ended””All the programs for the channel are in the past. Vidori doesn’t import programs that have ended, and it keeps the current schedule instead of replacing it with an empty one. Upload a file with programs that haven’t ended yet.
”No program in the file for channel <channel id> could be imported. <warnings>”
Section titled “”No program in the file for channel <channel id> could be imported. <warnings>””Every program was skipped. The warnings after the sentence say why, for example 2 programs were skipped: 1 with no title, 1 with no end time. Fix the reasons listed (see Skipped and trimmed programs) and upload again. The channel keeps its current schedule.
”The uploaded file wasn’t found. Upload it again.”
Section titled “”The uploaded file wasn’t found. Upload it again.””Vidori couldn’t find the file you uploaded. Choose the file again and upload it once more.
”The file is larger than 20 MB, the most an EPG upload can be.”
Section titled “”The file is larger than 20 MB, the most an EPG upload can be.””Vidori found the uploaded file to be over 20 MB. This is the same limit as above: make the file smaller and upload it again.
”Failed to upload the EPG file”
Section titled “”Failed to upload the EPG file””Something went wrong on Vidori’s side while importing. The channel keeps the schedule it had. Try again in a few minutes. If it keeps failing, contact support.
”The import failed (HTTP <status>).” or “The import failed.”
Section titled “”The import failed (HTTP <status>).” or “The import failed.””The import request didn’t get a usable answer, so Vidori can’t tell whether it worked. Open the EPG tab again and check Last upload. If it didn’t change, upload the file again.
”Couldn’t load the EPG status”
Section titled “”Couldn’t load the EPG status””The tab couldn’t read the channel’s EPG summary. The message under the title says why. Click Retry. You can still upload a file while the status isn’t loaded. In that case the Replace the schedule? question is always shown, with the extra line The EPG status couldn’t be loaded, so this channel may have programs that haven’t ended.