800.885.8886 sales@telvue.com
  • Facebook
  • Twitter
  • Facebook
  • Twitter
TelVue
  • Home
  • Products
    • Playback & Automation
      • HyperCaster®
      • ProVue®
        • ProVue® HD
        • ProVue® GFX
        • ProVue® CC
      • TelVue TeleCastTM 2
    • Streaming/Cloud
      • TelVue CloudCast™
      • TelVue Connect™
      • Media Exchange
      • Mobile & OTT Apps
      • TelVue SmartCaption™
    • Digital Signage
      • TelVue InfoVue™
    • Automatic Captioning
      • SmartCaption™
    • Ad Insertion
      • TelVue AdCaster™
  • Solutions
    • Cable/Telco
    • Community Media
    • Media Companies
  • Support
    • Knowledge Base
    • Webinars
    • Training Videos
    • Documentation
    • Contact Support
  • News
    • Blog
    • Press
    • Awards
  • Client Logins
    • Connect/CloudCast
    • InfoVue
  • Contact Us
    • General & Sales
    • Technical Support
Select Page

HyperCaster

HyperCaster User Manual
    HyperCaster Configuration
    • Config Tab
    • Channel Setup
    • Continuity
    • Live Streams
    • Feed Setup
    • NDI Access Manager
    • ProVue Decoder Configuration
    • Configure In/Out Ports
    • Encode Profiles
    • Manage TeleCasts
    • Streaming Destinations
    • Streaming Rules
    • User Management
    • Content Settings
    • Pro Transcoding
    • Schedule Configuration
    • InfoVue XML
    • Switch Configuration
    • Remote Server Configuration
    • TelVue Connect Configuration
    • Captioning Configuration
    • Server Management
    • NTP, NTP Configuration, and NTP Health
    • Security Configuration
    • Network and Security
    • Setting up SSL/HTTPS on the HyperCaster
    • Backup Settings
    • IPMI
    • Config – Utilities
    • Version and Configuration
    • SNMP Support
    • External Devices
    • Brightcove EPG Integration
    • Add an RTMP Stream
    • Set Up an RTMP Stream in a HyperCaster
    • Set Up an SRT Stream in a HyperCaster
    • Set Up an HLS Stream in a HyperCaster
    • Get Channel Schedule as XML (Detailed)
    HyperCaster Content Management
    • Organize and Add Content
    • Content Management
    • Thumbnail and Table Views
    • Show Content Page
    • Content File Actions
    • Add TBD Program
    • DVD Import
    • Replacement Files Hot Folder
    • How to Trim a Video File (Virtual Trimming)
    • Trim Content (Built-in, Multiple Trim Editing)
    • Tasks
    • Previews
    • Turn On Transcoding
    • Create a HyperCaster Playlist
    • Series & Series Scheduling
    • Record or Capture
    • Upload to Connect/CloudCast
    • Archiving
    • Archive.org integration
    • Content Workflow Rules
    • Preparing Content for the HyperCaster
    • Content RSS Feed
    • Export to CSV
    • Searching
    • Using Third-Party Editing Software
    HyperCaster Programming
    • The Dashboard
    • Programming
    • Calendar View
    • Classic View
    • Search Filters and Event Functions
    • Field Descriptions and Display Options
    • Program Playout Event
    • Program Stream Event
    • Program Record Event
    • Program Input Event (AIO Only)
    • Input Locking
    • Program Switch Event
    • Scheduling a Live Switch Event whose Actual Duration Varies
    • Program Playlist Event
    • Program Overlay Event
    • Program Slide Event
    • Program Ad Trigger Event
    • Unschedule an Event
    • Event Actions
    • Copy Program Blocks
    • Import and Export events
    • Native CSV Formatting
    • Scheduling Conflicts and Ripple
    • Recurring Events
    • Controlling What Appears in the Program Guide
    • Publishing Your Schedule
    • Schedule Ads
    HyperCaster Graphics
    • Graphic Overlays
    • Overlay Rules
    • Bugs
    • Tickers
    • How to Build RSS Tickers
    • Snipes
    • Clocks
    • Program Guides
    • Emergency Notification Console
    • Join in Progress Overlay
    HyperCaster Reports
    • Reports Tab
    • As Run Reports
    • Program Guide Report
    • Missing File Report
    • TelVue Connect Report
    HyperCaster Captioning
    • SmartCaption™ Automatic Captioning Integration
    HyperCaster Streaming
    • Configure In/Out Ports
    • Streaming Destinations
    • Encode Profiles
    • Manage TeleCasts
    • Streaming Rules
    HyperCaster Miscellaneous
    • System Health
    • Backups
    • Safety Requirements
    • Glossary
    HyperCaster Guide to CCMS Plus
    • Guide to CCMS Plus
    • CCMS Plus Setup
    • CCMS Schedule Remote Directory Folder Structures
    • Schedule and Media Imports
    • Verification File Export
    • Tasks Tab
    • E-Mail Notifications of Missing Content
HyperCaster FAQs
  • How do I access the UI for my HyperCaster?
  • What is the difference between, “enable continuity” and “continuity resume”?
  • Port Forwarding Rules to Allow External Access to the HyperCaster
  • How to Stream a Zoom Meeting to the HyperCaster
  • Extending an IP Capture without Re-Entering Metadata
  • YouTube Live
  • How do I set InfoVue as Continuity on the HyperCaster?
  • How do I embed a HyperCaster Program Guide in my website?
  • Facebook Live
  • What does “ripple” mean?
  • Does the preview player under edit show timecode or full length of video?
  • What is the RSS feed button in the HyperCaster?
  • How to Add a TriCaster Feed to the HyperCaster
  • Mapping the HyperCaster to Your Desktop
  • How to display NOAA weather RSS as HyperCaster Ticker
  • How to Stream a WebEx Meeting to the HyperCaster
  • Is it possible to run a PowerPoint through my HyperCaster?
  • Why is my NTP server showing a critical status?
  • How to Add a LiveU Solo Feed to the HyperCaster
  • TelVue Server LED Status Indicators
  • On the Channel Setup page, what are the “Website Guide Details” checkbox and the “TV Guide Station ID”?
  • Go LIVE from anywhere with a JVC GY-HM200 and a HyperCaster
  • How do I display Program guide?
  • What is MPEG?
  • Prepare Content for HyperCaster with Sorensen Squeeze
  • Use OBS to Live Stream Skype, GoToMeeting, or any Application Window to Your HyperCaster
  • On the “Health” page, was does NTP define?
  • Preparing Content for your HyperCaster Using Telestream Episode Pro
  • Is it possible to run two channels to the same IP address with different ports?
  • Is it possible to run two Ethernet connections out of the HyperCaster? (Additional Card Required)
  • Are 16:9 files automatically letterboxed?
  • Server rooms: some practical advice
  • Is it possible to run background audio from a stream that is different than the video scheduled (ex. Radio Feed)?
  • I am having issues with the overlays. They schedule but won’t play.
  • Loss-of-Video Failover Protection with This Easy Trick
  • On the “Edit Content” page, what does the “Private” checkbox, Location and Contributor fields define?
  • When using FTP are we able to change the password for psguser?
HyperCaster APIs
    HyperCaster API Content Workflow
    • Access All Content Metadata as CSV
    • Import Content (Hot Folder)
    • Uploading Files on Schedule
    HyperCaster API Content Methods
    • Get All Content Metadata
    • Get Content Metadata by Filename (REST)
    • Get Content Metadata by ID (REST)
    • Get Content Thumbnail (REST)
    • Add Content (REST)
    • Edit Content (REST)
    • Delete Content (REST)
    • Add Content (SOAP)
    • Edit Content (SOAP)
    • Delete Content (SOAP)
    HyperCaster API Schedule Workflow
    • Access Playback (As-Run) Log
    • Import Events (Hot Folder)
    HyperCaster API Schedule Methods
    • Get Channel Next Playing (REST)
    • Get Channel Now Playing (REST)
    • Get Channel Schedule as RSS (REST)
    HyperCaster API Channel Management
    • Get Channel Settings (REST)
    HyperCaster API System Management
    • Get System Health as RSS (REST)
    • Get Software Version (REST)
    • Get Network Settings (REST)
  • Home
  • Knowledge Base
  • HyperCaster Knowledge Base
  • HyperCaster
  • HyperCaster APIs
  • HyperCaster API Schedule Methods
  • Get Channel Schedule as RSS (REST)

Get Channel Schedule as RSS (REST)

Overview

The Schedule RSS feed, linked from the dashboard, provides information about a channel’s upcoming schedule in RSS (XML) format. There are a few options about how much data to have this service return.

Request URL

To get the schedule for a specific channel as XML, you can pass the Channel ID, for example:

http://myserver/xml/program_schedule_feed/[?channel_id=1-20]

Substitute your server’s hostname, domain, or IP address for myserver. Optional parameters are show in brackets [].

Parameters

Parameter Type Required Format Description
channel_id Integer Range from 1 to 20 (depending on your server) Channel ID. If omitted, the schedule for all channels is displayed.
start DataTime YYYYMMDD Filter results to exclude everything prior to this date. If omitted, today’s date is used.
end DataTime YYYYMMDD Filter results to exclude everything after this date. If omitted, range ends one week from today.

Examples of valid URL parameters and what they return:

  • http://myserver/xml/program_schedule_feed/ – Returns one week of data forall channels.
  • http://myserver/xml/program_schedule_feed/?channel_id=1 – Returns one week of data for Channel 1.
  • http://myserver/xml/program_schedule_feed/?channel_id=4 – Returns one week of data for Channel 4.
  • http://myserver/xml/program_schedule_feed/?channel_id=3&start=YYYYMMDD&end=YYYYMMDD – Returns data from date range specified for Channel 3.
  • http://myserver/xml/program_schedule_feed/?channel_id=3&end=YYYYMMDD – Returns data from today to end date specified for Channel 3.
  • http://myserver/xml/program_schedule_feed/?channel_id=1&start=YYYYMMDD – Returns data from today to one week from now for Channel 1.

Code Examples

Testing

Testing different feed parameters can be done with a web browser. The /xml/program_schedule_feed URL displays a basic RSS 2.0 feed of the channel schedule.

In your browser, go to http://myserver/xml/program_schedule_feed/ (substitute the hostname of your server).

Parsing Date Field

The date is presented in RFC 2822 format, commonly used in email formatting. This format contains both relative time (that is, modified by time zone), and the timezone information (represented as +/- Greenwich Mean Time). The example below uses GMT -5, or Eastern Standard Time. The timezone information is placed at the end of the title string after a ” – ” separator.

In all programming languages, to get the desired date format:

  • Parse it from the pubDate field.
  • Use the language’s date-parsing features to get the RFC representation into a Date object.

PHP

function parsePsgRss($pubDate) {
$timestamp = strtotime($pubDate);
$hr_date = date(“g:i A”, $timestamp);return $hr_date;
}echo parsePsgRss(“Sample Program Two – Tue, 13 Jan 2009 22:00:00 -0500”);

PHP’s strtotime() function can read RFC2822 directly. That converts it to a Unix timestamp (seconds since the epoch). Other PHP date functions then take that timestamp directly. For example, Date takes a date format string to return just “10:00 PM” in this example string.

JavaScript

function getDateObject(pub_date) {
return new Date(pubDate);
}// Given a Javascript date object, return time in friendly format (8:00 AM).
function getHHMM(date) {
// Accepts JS Date and returns time as H:MM AM/PM.
hours = (date.getHours() > 12) ? (date.getHours() – 12) : date.getHours();
minutes = date.getMinutes() < 10 ? “0” + date.getMinutes() : date.getMinutes();
time = hours + “:” + minutes + ” ” + ((date.getHours() > 11) ? ‘PM’ : ‘AM’);
return time;
}

The first function parses off the RFC time and turns it into a Javascript Date object, a built-in object in Javascript. The second function takes a date object, and returns just “10:00 PM”.

One way to call the two Javascript functions is:

getHHMM(getDateObject(“Tue, 13 Jan 2009 22:00:00 -0500”);

Returns

Success

Here is an example RSS feed XML response:

<rss xmlns:psg=”http://192.168.41.126:80/psg_namespace/” version=”2.0″>
<channel>
<title>Channel 1</title>
<description>Broadcast Channel 1</description>
<item>
<title>Ad Council – Energy Efficiency</title>
<pubDate>Thu, 07 Mar 2019 17:00:00 -0500</pubDate>
<psg:eventId>19</psg:eventId>
<psg:duration>30</psg:duration>
<psg:end_datetime>Thu, 07 Mar 2019 17:00:30 -0500</psg:end_datetime>
<psg:programCode/>
<psg:episode>Cliff</psg:episode>
<psg:episodeCode/>
<psg:thumbnail>http://192.168.41.126/thumbnails/16.jpg?1551989877</psg:thumbnail>
<psg:mediumId/>
<vodURL/>
<description>
New PSAs released in 2011 encourage homeowners to save energy by taking actions around the home. The PSAs offer practical ideas for reducing household energy consumption, and saving money in the process.
</description>
<link>http://10.10.10.10</link>
<guid>AC1F6B49B180-19</guid>
</item>
</channel>
</rss>

Several key fields of the content metadata are made available, including the Program field (in the title element), the description, the thumbnail, and duration.

A Note on What “Title” Contains in the RSS. For each content file, if you fill in the “Program” metadata field, then “Program” is the string presented as “title” in the RSS. Otherwise, the filename is presented in the RSS. The fields Program Code, Episode, and Episode Code have no impact here. The RSS title will be “Program” or, if Program is blank, the filename.

Failure

Invalid Channel

<?xml version=”1.0″ encoding=”UTF-8″?>
<hash>
<errors>There were problems with your schedule query parameters. An invalid channel was specified.</errors>
</hash>

History

Introduced
Princeton Server 3.6.5

 

Share This Article :
  • Facebook
  • Twitter
  • LinkedIn
  • Pinterest
Still stuck? How can we help?

How can we help?

Updated on December 1, 2022
Get Channel Now Playing (REST)

PRODUCTS

  • Playback & Automation
    • HyperCaster®
    • ProVue®
      • ProVue® HD
      • ProVue® GFX
      • ProVue® CC
    • TelVue® TeleCastTM 2
  • Streaming/Cloud
    • TelVue CloudCast™
    • TelVue Connect™
    • Media Exchange
    • Mobile & OTT Apps
    • TelVue SmartCaption™
  • Digital Signage
    • TelVue InfoVue™
  • Automatic Captioning
    • SmartCaption™
  • Ad Insertion
    • AdCaster™

SUPPORT

  • Contact Support
  • Knowledge Base
  • Training Videos
  • Product Documentation

ABOUT

  • Contact Us
  • TelVue News for Hyperlocal Broadcast, PEG news, and TV Technology
  • Press Releases
  • Executive Profiles
  • Sales Team
  • Company
  • Partners

BLOG POSTS

  • FreightWaves Taps HyperCaster AIO for Flexible Ad Integration with Brightcove
  • HyperCaster Integrated Streaming & Social Streaming Automation
  • Live Dual-language Captioning, Multiple Trim Editing, and Multistreaming Automation with HyperCaster™ 8.3
  • AIO Integrated Streaming, Program Guide & Clock Overlays with HyperCaster™ 8.2
  • Channel Streaming Rights Management with HyperCaster™ 8.1
  • Facebook
  • Twitter
16000 Horizon Way, Suite 100, Mt. Laurel, NJ 08054 - TelVue Corporation ® All Rights Reserved 2020