====== general ======


all channels are out of the box available as RSS, XSPF and AMP (adobe media player) feed. to enable a custom xml format you have to assign an XML template to one of your channel´s feed-slots. the way to do so is described [[tools:editchannelproperties|here]]. to learn how to create your own XML templates you should read [[tools:xmleditor|the xml template editor notes]].


===== differences between webTV and XML output =====

the webTV player pumps out your playlists exactly as programmed in your VJ console. but since XML feeds are used mainly within external aggregators, the XML output is slightly different from your programmed schedule to take care of typical aggregator -requirements and behaviors. \\

E.g.: RSS readers usually do collect and identify new items by evaluating the "guid" tag. this tag is used to identify a specific item entity. if a feed reader catches an item it will match its guid against already aggregated ones and will discard the item if it was aggregated before. this makes shuffled play lists kind of useless and - still e.g. -  we pump out the "last in first out" order per default.\\
\\
however, feedbeat wouldn´t be feedbeat if there wheren´t any customizing options to break this systemside chains. if you do not like the differences between webTV and XML as listed below, you are free to use additional URL parameters to force a specific delivery method (or format).\\
\\

^XML output ^webTV (projekktor) ^
|per default items are pumped out "last in, first out" |dramaturgic playback order as programmed |
|per default delivers 50 items at once only |delivers unlimited items as programmed |
|trailer and advertisement injections are not "looped" |injections as programmed |




====== XML URLs ======

<note tip>
techniques described here can also be applied to webTV pages  at
<code>
http://<VJ / username>.feedbeat.com/<channel name>/tv/
</code>
please note that in this case the //default limit// is //unlimited// not //50// as described below
</note>




===== available formats =====

^short ^format ^
|rss |media RSS V2.0 (verified) |
|xspf |[[http://www.xspf.org|XML shareable playlist format]] |
|amp |[[http://labs.adobe.com/technologies/mediaplayer/|Adobe Media Player optimized feed (experimental)]] |
|feeda |optional custom XML format as defined by channel operator |
|feedb |optional custom XML format as defined by channel operator |
|feedc |optional custom XML format as defined by channel operator |
|feedd |optional custom XML format as defined by channel operator |

===== URL (GET) parameters =====

you can justify the feeds content by adding one or more of the following URL parameters. parameters can be assigned in oldschool GET-style or as (rewritten) pairs of values seperated by "/". E.g:

<code>
standard path to feed:
http://demo.feedbeat.com/demo/feeda/

with parameters:
http://demo.feedbeat.com/demo/feeda/?bucket=testfiles&search=coolvids

same as:
http://demo.feedbeat.com/demo/feeda/bucket/testfiles/search/coolvids/
</code>






===== recognized parameters =====


^name ^valid values / format  ^purpose / result ^default ^example ^
|limit |numeric - max. 500 |maximum amount of items returned by the feed |50 |/limit/10/ returns... who knows? yes... 10 items |
|offset |numeric |items skipped till playback |0 |/offset/5/ skips the first 5 items of the regular feed /offset/5/limit/5/ returns feeditems 6,7,8,9 and 10 (if available) |
|browse |numeric |simple shortcut for //offset// / //limit// combinations begins output with //browse// multiplied by //limit// |none or 1 |/browse/2/limit/5/ will return feed items 6,7,8,9 and 10 - /browse/2/ will return items 51,52+n, 100 because default //limit// is 50 |
|tag |string |feed will return items tagged with //tag// only |none |/tag/dogs/ |
|search |string |feed will return items with title and/or descriptions matching //search// term |none |/search/cats/ |
|bucket |string |feed will pump out items of specified bucket only |none |/bucket/samplebucket/ |
|mode | //see below// |switch between different playlist orders |regular |/mode/regular/ |
|     | regular (default) |last in-first out order - best choice for podcast- and other mediaRSS readers | |/mode/regular/ |
|     | dramaturgic | //dramaturgic// order as programmed by VJ | |/mode/dramaturgic/ |
|     | alpha |alphanumeric playlistorder (0-9A-Z) | |/mode/alpha/ |
|     | alphaup |reverse alphanumeric playlistorder (Z-A9-0) | |/mode/alphaup/ |
|seed | numeric |fixes the "random seed" to a specific value in a way that you can "//page"// through "//dramaturgic//" playlists without total confusion| |/seed/2/ |