RSSRadio API
RSSRadio Version 1.1 onwards supports plugins which allow independant developers to extend and even replace parts of RSSRadios functionality.
The "developer pack" is now available for download which contains 2 examples of different types of plugins:
RSSRadio_DeveloperPack.zip
...from the developer pack...
RSS Radio Developer Pack
========================
All these examples were compiled on Visual Studio 2003.
RSSRadioInterfaces.DLL
This DLL contains the interfaces used in the RSSRadio object model.
1. PluginExample
This is an example of a generic plugin that can appear on the RSSRadio menu and manipulate RSSRadio via the object model. Plugins of this type must be in the RSSRadio program directory called plugin(something).dll.
2. WMPlayer
This is an example of a replacement WMPlayer.dll (actually its mostly the one that ships with RSSRadio). You can replace the iTunes.dll or the WMPlayer.dll to have RSSRadio interface to any media player by including HKLMSoftwareDoradaRSSRadioPlugins[iTunes][WMPlayer]="dllname"
Information for Podcasters
RSSRadio supports RSS 2.0 feeds with enclosures.
Recommended tags:
Channel
- <title>
- <link>
- <description>
Item(s)
- <title>
- <description (valid xhtml)>
- <link>
- <enclosure>
- <pubDate>
- <guid>
File Associations
RSSRadio is associated with the .opml extension on the users pc (mime application/x.opml+xml).
RSSRadio is associated with the .podcast extension on the users pc (mime application/podcast+xml).
Users will be able to single click download an application/x.opml+xml file or application/podcast+xml on a webserver and RSSRadio will subscribe them.
Other Information:
<ttl> tag supported in channel
enclosure types */audio */video application/x-bittorrent
Bittorrent support - torrent files should contain only 1 audio file
supports cookies
supports the content-disposition header
supports HTTP HEAD to get filesize / last-modified
supports HTTP resume
supports RSS autodiscovery from your root url by including <link rel="alternate" type="application/rss+xml" title="RSS 2.0" href="xxxxxx" />
RSS_Radio Directory Crawler
Feed owners and administrators may see traffic from the useragent "RSS_Radio Directory Crawler".
This program travels around indexing RSS Feeds and placing the URL, Title, Description and iTunes:Image into a database that RSSRadio users can search in order to find pre-validated and well described feeds.
Generally feed owners would want to treat the crawler like any other client, the exception is when the owner does not want the feed added to the database, for instance if the feed is an unauthenticated "secret" or subscription feed, in this circumstance the feed owner should reject traffic from this user agent - do not send the agent any valid RSS or OPML data.
301 Moved Permanently
RSSRadio supports the iTunes behaviour of the HTTP response "301 Moved Permenantly"
If RSSRadio receives this during a request for an RSS Feed it will update the users client with the new URL and not request the old URL again.
For a temporary redirect use HTTP 307 Temporary Redirect.
example php:
header("HTTP/1.1 301 Moved Permanently");
header("Location:
http://example.org/foo");
