Skip to main content

Frequency Documentation

MRSS Ingestion

MRSS feeds offer flexibility in metadata and automation of ingestion. Frequency supports standard MRSS delivery as specified by the RSS Advisory Board, accommodating custom integrations from other vendors. Refer below for the required specifications for media, metadata, and an example MRSS feed.

Required MRSS Metadata

Type	Specifications	Example
Media URL	The video asset being ingested. Supported file extensions: mp4, avi, mov, mpg, mxf, mkv Minimum 1280x720 resolution 16:9 Aspect Ratio	<media:content url="http://www.foo.com/movie.mp4" />
Image URL	The image representing the video asset. Supported file extensions: jpg, png, webp Minimum 1280x720 resolution 16:9 Aspect Ratio	<media:thumbnail url="http://www.foo.com/keyframe.jpg" />
Title	A brief, descriptive title of the asset.	<title>My Favorite Show</title>
Description	A detailed description for the asset that will display in the EPG information.	<description>A new user enjoys Frequency Studio!</description>
GUID	A globally unique identifier for your asset. This can also be a static URL. Must be a unique value for every video in your feed	<guid>13o4hkhsf823</guid>

Optional MRSS Metadata

Frequency supports various custom metadata. Refer to "Managing Series Metadata " for additional asset info and "Metadata Definitions" Metadata Definitions" for accepted values. Custom values can map to Frequency metadata.Managing Series Metadata

Type	Specifications	Example
Series Title	Title for a series. Unrecognized titles are added to database	<frequency:seriesTitle>My New Series</frequency:seriesTitle>
Series GUID	Global Unique Identifier for the series. Consistent across systems for record keeping.	<frequency:seriesGuid>61455990483901</frequency:seriesGuid>
Series Description	Series description. Ingested first time a unique series is seen.	<frequency:seriesDescription>A succinct one or two sentence description.</frequency:seriesDescription>
Series Image	A 16x9 image representing the series. Shows title clearly.	<frequency:seriesThumbnail url="https://your.host.net/635ae9845046ac65230a0367/1280/720" />
Season Number	Part of season video is in. Ingested first time a unique season is seen.	<frequency:season>1</frequency:season>
Season Title	The title for the season.	<frequency:seasonTitle>Special Season</frequency:seasonTitle>
Episode Number	The episode that this video is a part of the season of. Will be ingested the first time a unique episode is seen.	<frequency:episode>3</frequency:episode>
Episode TItle	The title for the episode.	<frequency:episodeTitle>Special Episode</frequency:episodeTitle>
Closed Captions	URL to closed caption file. Supported formats: SRT, VTT	<media:subTitle href="https://subtitles.srt />
Genre/Subgenre	A two level hierarchy to categorize content. Including only a Genre is also supported. Multiple genre tags can be sent through.	<media:category>Comedy/Sitcom</media:category>
Cuepoints	Identify cue points in milliseconds. Ad insertion points in video.	<frequency:cuepoints>0,345000,1080000</frequency:cuepoints>
Keywords	Searchable terms for content description. Useful for creating playlists	<media:keywords>Jason Alexander,NBC</media:keywords
Region	The intended country of origin or distribution. This determines accepted parental ratings values based on country advisory board standards. Please use the ISO 3166standard 2 letter country codes.	<frequency:country>us</frequency:country>
Parental Rating	This should represent the minimum age required to watch this content according to the region the content is distributed.	<media:rating>TVPG</media:rating>
Content Format	Separates major content types.	<frequency:contentFormat>Show</frequency:contentFormat>
Content Type	Describes video theme across categories. This is the pattern, motif, or theme of the video.	<frequency:contentType>Episode</frequency:contentType>
Cut	Official release production or cut of the video.	<frequency:cut>Clip</frequency:cut>
Periodicity	Describes if video is part of a superset.	<frequency:periodicity>Daily</frequency:periodicity>
Date Available/Date Expired	Identifies rights availability for distribution.	<dcterms:valid> start=2002-10-13T09:00+01:00; end=2002-10-17T17:00+0100; scheme=W3C-DTF </dcterms:valid>
Custom Metadata	Open text field for custom integrations.	<frequency:custom>Any data is acceptable.</frequency:custom>

Example MRSS

Download this sample XML file here: frequency-mrss-sample.xml

<?xml version="1.0" encoding="UTF-8"?>
<rss xmlns:dcterms="http://purl.org/dc/terms/" xmlns:frequency="http://www.frequency.com/icd/namespace" xmlns:media="http://search.yahoo.com/mrss/" version="2.0">
   <channel>
      <title>RSS Title</title>
      <description>This is an example of an RSS feed</description>
      <item>
         <title>The Contest</title>
         <description>George's mother throws her back out when she falls down after catching George performing a personal act; the gang partakes in a contest of self-denial. </description>
         <pubDate>Wed, 18 Nov 1992 18:00:00 +0000</pubDate>
         <guid isPermaLink="false">13o4hkhsf823</guid>
         <media:group>
            <media:content url="http://www.foo.com/movie.mp4" fileSize="12216320" type="video/mp4" medium="video" bitrate="2500" channels="2" duration="1380" height="720" width="1280" lang="en" />
            <media:thumbnail url="http://www.foo.com/keyframe.jpg" width="1280" height="720" time="12:05:01.123" />
                        <media:subTitle type="application/srt" lang="en" href="https://captions.srt"/>
         </media:group>
         <media:category scheme="http://www.frequency.com/icd/category_scheme">Comedy/Sitcom,TV/Comedy</media:category>
         <media:keywords>Seinfeld,Jason Alexander,NBC</media:keywords> 
         <frequency:contentFormat>Show</frequency:contentFormat>
         <frequency:contentType>Episode</frequency:contentType>
         <frequency:country>us</frequency:country>
         <media:rating scheme="urn:v-chip">TVPG</media:rating>
         <dcterms:valid>
            start=2002-10-13T09:00+01:00;
            end=2002-10-17T17:00+0100;
            scheme=W3C-DTF
         </dcterms:valid>
         <frequency:cuepoints>0,345000,1080000</frequency:cuepoints>
         <frequency:cut>Full Length</frequency:cut>
         <frequency:periodicity>Episodic</frequency:periodicity>
         <frequency:seriesGuid>61455990483901</frequency:seriesGuid>
         <frequency:seriesTitle>My New Series</frequency:seriesTitle>
         <frequency:seriesDescription>A succinct one or two sentence description.</frequency:seriesDescription>
         <frequency:seriesThumbnail url="https://your.host.net/635ae9845046ac65230a0367/1280/720" />
         <frequency:season>1</frequency:season>
         <frequency:seasonTitle>Special Season</frequency:seasonTitle>
         <frequency:episode>3</frequency:episode>
         <frequency:episodeTitle>Special Episode</frequency:episodeTitle>
         <frequency:custom>Any data is acceptable.</frequency:custom>
      </item>
      <item>
         <title>Title of media2</title>
         <description>Description of media</description>
         <pubDate>Sun, 06 Sep 2009 16:20:00 +0000</pubDate>
         <guid isPermaLink="false">13o4hkhsf923</guid>
         <frequency:lastModified>Sun, 06 Sep 2009 16:20:00 +0000</frequency:lastModified>
         <media:group>
            <media:content url="http://www.foo.com/movie.mp4" fileSize="12216320" type="video/mp4" medium="video" isDefault="true" expression="full" bitrate="128" framerate="25" samplingrate="44.1" channels="2" duration="185" height="720" width="1280" lang="en" />
            <media:thumbnail url="http://www.foo.com/keyframe.jpg" width="1280" height="720" />
            <media:subTitle type="application/srt" lang="en" href="https://captions.srt"/>
 </media:group>
                 <frequency:periodicity>Daily</frequency:periodicity>
         <frequency:cuepoints>0,345000,1080000</frequency:cuepoints>
         <frequency:contentType>Stand Up</frequency:contentType>
         <frequency:cut>Full Length</frequency:cut>
         <frequency:country>us</frequency:country>
         <media:rating scheme="urn:v-chip">TV-PG</media:rating>
         <frequency:periodicity>Episodic</frequency:periodicity>
         <frequency:contentFormat>Show</frequency:contentFormat>
         <media:category scheme="http://www.frequency.com/icd/category_scheme">TV/Comedy</media:category>
         <media:keywords>Jerry Seinfeld,George Costanza,</media:keywords>
      </item>
   </channel>
</rss>

In this section: