Get Channel Now Playing (REST)

Overview

The nowplaying function displays a basic RSS 2.0-like feed that describes what is currently playing on the channel.

Request URL

http://myserver:3000/xml/nowplaying

Substitute the hostname, domain, or IP Address of your server instead of myserver.

Parameters

Parameter Type Required Format Description
id Integer Range from 1 to 20 (depending on your server) Channel ID. If omitted, Channel 1 is used.

Examples of valid URL parameters and what they return:

  • http://myserver:3000/xml/nowplaying – Returns currently playing program on Channel 1.
  • http://myserver:3000/xml/nowplaying/2 – Returns currently playing program on Channel 2.

Returns

Success

The feed’s response can be tested in a web browser. Browse http://myserver:3000/xml/nowplaying in your web browser. The information displayed depends on your browser, but typically includes the program name, date and time of broadcast, and a description from the content metadata as in this example:

Screenshot: "Now Playing" RSS

XML of a successful response:

< ?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:psg="http://myserver:3000/psg_namespace/">
  <channel>
    <title>TelVue Princeton Channel 1</title>
    <description>TelVue Princeton Broadcast Channel 1</description>
    <link></link>
    <item>
      <title>Sample Program - Tue, 09 Dec 2010 12:00:30 -0500</title>
      <description>A sample program with metadata.</description>
      <psg :thumbnail>http://myserver:3000/thumbnails/1.jpg</psg>
      <link>http://10.10.10.10</link>
      <duration>357.0</duration>
      <guid>Sample_Program.mpg</guid>
    </item>
  </channel>
</rss>

Leave a Reply