summaryrefslogtreecommitdiffstats
path: root/xbmc/guilib/GUIRSSControl.dox
blob: e51430cdddc8e75cb979ca8100e56d51bae4fb71 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
/*!

\page RSS_feed_Control RSS ticker
\brief **Used to display scrolling RSS feeds.**

\tableofcontents

Kodi can display an RSS feed on the home screen of the default skin/interface
(Estuary), as well as any other skin that supports RSS feeds. By default,
the RSS news feed is taken from [http://kodi.tv](http://kodi.tv/), but the feed
can be changed to almost any RSS feed.

@note Don't confuse the RSS ticker with RSS media source, which allows access to
video and/or audio RSS streams.


--------------------------------------------------------------------------------
\section RSS_feed_Control_sect1 RSS ticker settings

The RSS ticker can be toggled on or off by going to
<b>`Settings -> Appearance -> Skin -> Show RSS news feed`</b>

Below this setting one can also change the RSS news feed address.


--------------------------------------------------------------------------------
\section RSS_feed_Control_sect2 Technical documentation for skinners

  Main page: [Skin development](http://kodi.wiki/view/Skin_development)

\subsection RSS_feed_Control_sect2_1 RSS control
The rss control is used for displaying scrolling RSS feeds from the internet
in Kodi. You can choose the font, size, colour, location and the RSS feed to
be displayed.

__Example:__

~~~~~~~~~~~~~
<control type="rss" id="1">
  <description>My First RSS control</description>
  <posx>80</posx>
  <posy>60</posy>
  <width>500</width>
  <visible>true</visible>
  <font>font14</font>
  <textcolor>FFB2D4F5</textcolor>
  <headlinecolor>FFFFFFFF</headlinecolor>
  <titlecolor>FF655656</titlecolor>
</control>
~~~~~~~~~~~~~


\subsection RSS_feed_Control_sect2_2 Available tags and attributes

In addition to the [Default Control Tags](http://kodi.wiki/view/Default_Control_Tags)
the following tags are available. Note that each tag is **lower case** only. This is
important, as `xml` tags are case-sensitive.

| Tag           | Description                                                   |
|--------------:|:--------------------------------------------------------------|
| id            | This refers to the feedset to be displayed. This is the id reference to the <b>`<set>`</b> section in [RssFeeds.xml](http://kodi.wiki/view/RssFeeds.xml) (see below):
| font          | Specifies the font to use from the font.xml file.
| textcolor     | Specified the color the text should be. In hex **AARRGGBB** format, or a name from the [colour theme](http://kodi.wiki/view/Colour_Themes).
| shadowcolor   | Specifies the color of the drop shadow on the text. In **AARRGGBB** format, or a name from the [colour theme](http://kodi.wiki/view/Colour_Themes).
| headlinecolor | Specified the color that any highlighted text should be. In hex **AARRGGBB** format, or a name from the [colour theme](http://kodi.wiki/view/Colour_Themes).
| titlecolor    | Specified the color the titles of the feeds should be. In hex **AARRGGBB** format, or a name from the [colour theme](http://kodi.wiki/view/Colour_Themes).
| scrollspeed   | Scroll speed of text in pixels per second.


\subsection RSS_feed_Control_sect2_3 RssFeeds.xml

- <em>Main page: [RssFeeds.xml](http://kodi.wiki/view/RssFeeds.xml)</em>

The actual content of the RSS feed is defined in the
[RssFeeds.xml](http://kodi.wiki/view/RssFeeds.xml) file stored in the user's
profile. Here is an example :

~~~~~~~~~~~~~
 <rssfeeds>
   <set id="1">
     <feed updateinterval="30">http://feeds.feedburner.com/XboxScene</feed>
     <feed updateinterval="30">http://feeds.wired.com/wired/topheadlines</feed>
   </set>
   <set id="2">
     <feed updateinterval="30">http://www.cnet.co.uk/feeds/public/rss_news_10.htm</feed>
   </set>
 </rssfeeds>
~~~~~~~~~~~~~

As can be seen, each feedset has an id attribute – this is what we are
referencing in the <b>`<id>`</b> attribute of the control. There can be more
than one <b>`<set>`</b> defined, and more than one <b>`<feed>`</b> per
set. The <b>`<feed>`</b>'s must be escaped so that they're xml-safe (ie replace &
with & etc.). Each feed in the set runs through in the order they are defined.


--------------------------------------------------------------------------------
\section RSS_feed_Control_sect3 See also

- [RssFeeds.xml](http://kodi.wiki/view/RssFeeds.xml)

#### Development:
- [Add-on development](http://kodi.wiki/view/Add-on_development)
- [Skinning](http://kodi.wiki/view/Skinning)

*/