RiMTs Documentation

Administrator's guide to the channel, EPG and metadata panel.

1. What RiMTs does

RiMTs holds the television schedule and everything attached to it. Channels are described once, their programmes arrive from an EPG source or are entered by hand, each programme is linked to a metadata record with its titles, descriptions, images and classifiers, and the whole picture is handed on to client systems by the exporters.

The panel is shared by several providers. A provider owns its channels, EPG sources, exporters and administrators, and its people see only what belongs to them. Only a system administrator sees across providers.

2. Signing in

Sign in with the username and password your administrator gave you. If the account has two-factor authentication switched on, a code is asked for right after the password.

Two-factor authentication

An administrator can require two-factor authentication for an account. On the next sign-in the panel shows a QR code to scan with an authenticator application, and from then on the six-digit code is asked for at every sign-in. If the phone is lost, an administrator can reset the second factor on the account, and the setup starts again.

Your profile

Your name in the top bar opens the profile, where you set:

  • name and e-mail;
  • Timezone and Panel timezone — programme times are stored in GMT and shown to you in the zone chosen here;
  • the notification topics you are subscribed to;
  • the timeline's zoom and how many pictures fit in a row.

The password is changed from the same menu.

3. Roles and what they open

An account carries one or more roles, and the menu shows only the sections its roles open.

Role What it opens
System administrator Everything, across every provider: providers, all channels and EPG sources, import templates, servers and the Rimts parameters. Includes every role below.
Tenant administrator Everything belonging to its own provider — channels, EPG sources, administrators — and all the editor roles below.
EPG editor The programme sections: summary, the day view, and the imports.
Metadata editor The metadata section: instances, persons, classifier lists, audience limits.
Tags editor Tags, and the programme editor where tags are attached.
VOD editor The VOD section: content providers and their sources.
VOD marks editor Editor marks on VOD material.
Exporter manager Data exporters and EPG sending.
API user No panel of its own — the account is used by another system through the API.
A tenant administrator manages people inside its own provider only. Creating providers, editing the Rimts parameters and reaching another provider's data are system administrator work.

4. Programmes

Summary

Programmes → Summary is the wall chart: every channel you can see, a column per day, and the state of that day at a glance. Use it to spot the days that are still empty or thin, and to jump straight into a day by clicking its cell.

Selecting cells and pressing Import from db runs the EPG source import for exactly those channel-days, one after another, so a week of several channels can be filled in one go. The search box filters the channel list by name.

The day view

Clicking a channel-day opens the day: a strip of days along the top, and the timeline of that day below it. The strip switches days without leaving the page; today is marked.

Every programme is a block on the timeline, drawn from its start to its stop. Clicking one opens it for editing underneath. Overlaps and gaps are visible in the shape of the timeline itself, which is the quickest way to check a freshly imported day.

The buttons under the timeline:

Create newAn empty programme in this day.
DeleteRemoves the programmes ticked in the timeline.
Lock / UnlockProtects the ticked programmes from imports — see Locking.
Import from txtFills the day — or several days at once — from pasted text, see Import from txt.
Duplicate fromCopies another day of this channel into this one — see Duplicate from.
Import from dbFills the day from the channel's EPG source — see Import from db.

Editing a programme

An open programme has:

  • Start and stop — in your panel timezone. Changing them moves the block on the timeline.
  • Title and description in each of the channel's languages. These are what the exporters send out.
  • Age rating, Live and Recordable flags.
  • TVA classifiers — content, format, intention and intended audience, picked from the classifier lists.
  • Metadata — the record this broadcast is an instance of. Search for an existing one and attach it, or create one from the programme. Everything on the metadata record — images, persons, IMDB data, tags — is shared by every broadcast attached to it, on this channel and on others.
  • Images — the metadata record's images, in the formats the system keeps.
  • Tags — attached to the metadata record, visible to your provider or to everyone.

Import from txt

For channels that send their schedule as text rather than as a feed. Paste the day — or as many days as the supplier sent — choose the timezone the times are written in, and press Import. The timezone defaults to the channel's own.

The text is read like this:

  • columns are separated by a tab, by two or more spaces, or by ; / ,;
  • the order is [date] start [stop] title description image;
  • the stop time is optional — without it a programme ends where the next one starts, and the last one in the text gets an hour;
  • a leading date column sends the line into that day, so one paste can hold a whole week or month — see More than one day;
  • a line with no columns at all is split at the first period — title before it, description after.

An Import template can be picked instead of the automatic reading. A template is a pattern written for one supplier's exact layout; with one chosen, lines that do not match the pattern are ignored. Leave it on Auto detect unless you know the text needs a template.

An http(s) link in the image column is turned into the metadata record's pictures: a poster (352x528) and a screenshot (590x332), and a cover (1920x1080) when the source image is at least that big. The scaling is done by the image service, not by the panel, so the link has to be one that service can open too.

Whatever happens to the images, the rest of the lines are imported. Anything that failed is listed in one window at the end, naming the line it belongs to.

More than one day

A date in front of the start time decides which day the line goes into, so a schedule for several days is imported in one go. It can be written as 2026-09-10 or as 10.09.2026, 10/09/2026, 10-09-26 — with the slashes and dots the day comes first.

The date does not have to be on every line: a line without one goes into the same day as the line above it, which is enough for text that names the day once and lists the programmes under it. Lines before any date at all — and lines whose date cannot be read — go into the day open in the panel, and an unreadable date is named in the result window.

Times still run in the timezone picked in the import window, and a day that goes past midnight is handled as before: a start time earlier than the one above it belongs to the following day, and a stop time earlier than its own start ends the programme after midnight.

The result window lists every day the text went into and how many programmes each one got, and the panel opens the first of them when the day it was on got nothing. Days the strip of days on the page does not reach are imported just the same — open one of them from the Summary to see the result.

Duplicate from

Copies a whole day of this channel into the day open in the panel — the usual way to fill a weekly repeat. Press Duplicate from, pick the day to copy from (it opens on the same weekday a week earlier, and the weekday of both days is spelled out), and press Import.

Each programme is copied at the same time of day with everything attached to it: titles and descriptions in every language, the metadata link, age rating, the live and recordable flags, and the TVA classifiers. The copies are new programmes, so they are not locked.

The day being copied into is cleared first, so it ends up as a copy of the source day and not a mixture of the two. Locked programmes are the exception: they stay where they are, and the result window says how many were replaced and how many were left.

Import from db

Fills the day from the channel's own EPG source. The channel needs an EPG source and a source channel assigned to it (see Channels); without them the import says so and stops.

The arrow beside the button chooses what happens to locked programmes: leave them alone, overwrite them, or import around them. If the source has not changed since the last import, the panel says so instead of importing the same thing again.

Locking

A locked programme is one an editor has decided is final. Imports leave it alone, and so does Duplicate from. Tick the programmes in the timeline and use Lock or Unlock. Lock a hand-corrected programme before running an import over its day.

5. Metadata

Channels

Settings → Metadata → Channels lists the channels of your provider in their display order; the arrows move a channel up or down, and that order is what the summary and the exports follow.

A channel carries:

Title, logoThe name shown everywhere, and the logo picked from the channel photo database.
Default timezoneThe zone this channel's schedule is written in — the txt import starts from it.
Default language, output languagesThe language its texts arrive in, and the ones its programmes are kept in.
EPG source and source channelWhere Import from db takes the schedule from.
Title and description templatesImport templates used when reading that source's texts.
Priority in summaryWhere the channel sits in the channel list.
Enable EPG Source images auto-importWhether pictures arriving with the source are attached to the metadata.
EPG images auto-importWhich formats those pictures are saved as. Shown only while the switch above is on.
Adults channelMarks the channel as adult content.
Manual updateKeeps automatic imports away from the channel: it is maintained by hand.
EnabledA disabled channel stays in the panel but is not exported.

Tags

Tags mark metadata records — a themed selection, a campaign, anything an exporter or an editor needs to find later. A tag belongs either to your provider or to everyone; a provider's tags are invisible to the others. Tags are attached to metadata records, so a tagged record is tagged on every channel that broadcasts it.

Metadata instances

A metadata instance is the thing being broadcast, as opposed to the broadcast itself: a film, or one episode of a series. Records can be arranged in a hierarchy — series → season → episode — so that an episode inherits what belongs to the whole series.

A record holds its titles and descriptions per language, its content type (drama, show, sport), season and episode numbers, IMDB and TMDB data where it has been fetched, images, persons, and its tags. The list shows, per record, how many children, images, programmes and VOD items point at it.

Records are created from the programme editor while working on a day, or directly in Settings → Metadata → Metadata instances. Persons are kept in their own list and attached to records with their role.

Images

The system keeps a fixed set of picture formats:

FormatSizeUsed as
tv_vertical_2_3352 x 528poster
tv_horizontal_16_9590 x 332screenshot
tv_fhd_16_91920 x 1080cover

Pictures can be uploaded and cropped by hand in the programme editor, searched for in the image library, or created automatically from a link during an import. Each format keeps one current picture; older ones stay behind it and can be deleted one by one. A cover is only made from a source image that is at least 1920x1080 — a smaller original would only be stretched.

Classifier lists

Under Settings → Metadata are the lists the programme editor picks from: TVA content, TVA format, TVA intention and TVA intended audience, the XPRS genres and categories that incoming sources are mapped through, audience limits, and the persons, teams and championships used by sport programmes. They are shared by the whole system, so changing an entry changes what every programme using it means.

Import templates

An import template is a pattern that reads one supplier's text layout — which part of a line is the time, which is the title, which is the description. Templates are created by a system administrator in Settings → Metadata → Import templates, and are then selectable in the txt import and on the channel as its default. A channel with no template falls back to automatic reading, which handles the ordinary layouts on its own.

The form lists the groups a pattern can fill in. One of them is date: a template that captures it reads a text of several days the same way the automatic reading does — see More than one day.

6. Data exporters

An exporter is a client system that receives your EPG. Settings → Data exporters lists them with their type, address, how many channels they take and when they were last sent to.

Each exporter has:

  • a type — TV Anytime, XMLTV or Puzzleware — which decides the shape of the export;
  • the credentials and address it is delivered to, and where it expects images;
  • the channels it receives, chosen from your provider's channels, and how many days of each;
  • the languages and audience limits that apply to it;
  • Enabled — a disabled exporter is skipped by sending.

EPG sync → EPG send sends to the exporters: choose the type of client, how many days to send, and whether programmes and logos already sent should go again. What each export produced is kept in the export messages, reachable from the exporter list.

7. EPG sources

Settings → EPG sources is where the feeds come from. Each source has a data type, and the type decides which fields matter:

Data typeWhat it needs
XML TV, XML Radio, Schedules Direct, SPORT1XML URL, and a username and password if the file is protected.
XPRSChannels URL, EPG URL, username, password.
Mediapress, Mediapress TestChannels URL, EPG URL, password.
MediaPress V2API URL and API Token.

A source also carries its timezone and how often it is updated. The two commands that run the source — one to create its channels, one to import its programmes — are filled in automatically when the source is saved, so they are not asked for on the form.

In the list, Create runs the channel-creating command and Update the import. The channel count opens the source channels — these are the ones a channel is pointed at in its own settings — and the update interval opens the log of what each run did.

8. Administration

Providers

A provider is a tenant: its own channels, EPG sources, content providers, exporters and people. The list shows how much of each is attached to it. A provider can only be deleted once nothing is attached any more — the panel refuses and names what is still there, rather than quietly cutting the channels loose.

Administrators

Settings → Administration → Administrators is the account list. An account has a name, username and e-mail, the provider it belongs to, its roles (see Roles), its timezone, and whether it is enabled. Two-factor authentication can be required per account, and reset from the same form if the phone is lost.

A tenant administrator sees and manages only the accounts of its own provider. Neither the first account nor your own can be deleted.

Rimts parameters

System-wide settings: the company name, phone and e-mail shown in the panel, the patterns that mark a programme as not recordable, how many days of import messages are kept, whether IMDB search is available, and the Slack connection notifications are sent through. System administrator only.

9. VOD

The VOD section keeps the on-demand catalogue beside the schedule. Content providers are the catalogue suppliers; each has its sources, which are matched to the same metadata records the programmes use, so a film has one description and one set of images whether it is broadcast or offered on demand. Editor marks record what an editor has checked or still has to do on a VOD item.

10. When something goes wrong

What you see What it means
No imports performed as no changes in source detected. The EPG source is offering exactly what was imported last time. Nothing was changed.
Scaler returned no ... image for <link> The image service could not fetch or scale that picture. The programme itself was imported; only its picture is missing. If the message adds the link itself opens fine, the panel could read the source but the image service could not — the source host is unreachable from it.
Cannot open <link> The picture link itself does not answer. Check that it opens in a browser.
Images took over 60s ... Too many dead picture links in one paste. The rest of the lines were imported without pictures; fix the links and import again.
No lines decoded. The pasted text did not match the chosen template, or has no recognisable times. Try Auto detect, or check the column order.
A txt import of several days all landed on one day The date column was not read as a date: check that it is the first column and written as 2026-09-10 or 10.09.2026. With an import template chosen, the pattern also has to capture the date in a date group — see Import templates.
Programmes are missing after a txt import Most often a template is selected that does not match the pasted layout — lines it cannot read are skipped. Switch the template to Auto detect and import again.
An import leaves a locked programme untouched That is what the lock is for. Unlock it, or choose the overwrite option on Import from db.

Anything this guide does not answer belongs with your system administrator.