Difference between revisions of "Documentation:Modules/rss"

From VideoLAN Wiki
Jump to navigation Jump to search
(Expand, copy-edit, redact false information, remove old notes, remove {{Stub}}, GPL)
m (+{{Alignment mapping}}, internal anchor name consistency)
Line 23: Line 23:
 
}}
 
}}
 
{{Option
 
{{Option
|name=rss-position
+
|name=rss-position<span id="rss-position"></span>
 
|value=integer
 
|value=integer
|select={0, 1, 2, 4, 8, 5, 6, 9, 10}
+
|select=[[#appendix_rss-position|{0, 1, 2, 4, 8, 5, 6, 9, 10}]]
 
|default=-1
 
|default=-1
 
|description=You can enforce the text position on the video (0=center, 1=left, 2=right, 4=top, 8=bottom; you can also use combinations of these values, eg 6 = top-right)
 
|description=You can enforce the text position on the video (0=center, 1=left, 2=right, 4=top, 8=bottom; you can also use combinations of these values, eg 6 = top-right)
Line 40: Line 40:
 
}}
 
}}
 
{{Option
 
{{Option
|name=rss-color<span id="key_rss-color"></span>
+
|name=rss-color<span id="rss-color"></span>
 
|value=integer
 
|value=integer
 
|select={0x00000000, 0x00808080, 0x00C0C0C0, 0x00FFFFFF, 0x00800000, 0x00FF0000, 0x00FF00FF, 0x00FFFF00, 0x00808000, 0x00008000, 0x00008080, 0x0000FF00, 0x00800080, 0x00000080, 0x000000FF, 0x0000FFFF}
 
|select={0x00000000, 0x00808080, 0x00C0C0C0, 0x00FFFFFF, 0x00800000, 0x00FF0000, 0x00FF00FF, 0x00FFFF00, 0x00808000, 0x00008000, 0x00008080, 0x0000FF00, 0x00800080, 0x00000080, 0x000000FF, 0x0000FFFF}
 
|default=0xFFFFFF
 
|default=0xFFFFFF
|description=Color<sup>('''[[#appendix_key_rss-color|key]]''')</sup> of the text that will be rendered on the video. This must be an hexadecimal (like HTML colors). The first two chars are for red, then green, then blue
+
|description=Color<sup>('''[[#appendix_rss-color|key]]''')</sup> of the text that will be rendered on the video. This must be an hexadecimal (like HTML colors). The first two chars are for red, then green, then blue
 
}}
 
}}
 
{{Option
 
{{Option
Line 99: Line 99:
  
 
== Appendix ==
 
== Appendix ==
<span id="appendix_key_rss-color"></span>
+
<span id="appendix_rss-color"></span>
 
{| class="mw-datatable"
 
{| class="mw-datatable"
|+ Colour key for [[#key_rss-color|--rss-color]]
+
|+ Colour key for [[#rss-color|--rss-color]]
 
! scope="col" | Sample !! scope="col" | Hex code !! scope="col" | Colour
 
! scope="col" | Sample !! scope="col" | Hex code !! scope="col" | Colour
 
|-
 
|-
Line 136: Line 136:
 
|style="background-color:aqua;"| || <code>0x0000FFFF</code> || Aqua
 
|style="background-color:aqua;"| || <code>0x0000FFFF</code> || Aqua
 
|}
 
|}
 +
<span id="appendix_rss-position"></span>
 +
For --[[#rss-position|rss-position]]:
 +
{{Alignment mapping}}
  
 
{{Documentation}}
 
{{Documentation}}

Revision as of 06:17, 23 May 2019

Module: rss
Type Video sub-filter
First VLC version 0.8.4
Last VLC version -
Operating system(s) all
Description Overlays RSS and Atom feeds on the video
Shortcut(s) rss, atom

Options

  • rss-urls <string> : Pipe | separated list of RSS and/or Atom feed URLs default value: NULL

Position

  • rss-x <integer> : X offset, from the left screen edge default value: 0
  • rss-y <integer> : Y offset, down from the top default value: 0
  • rss-position <integer> {0, 1, 2, 4, 8, 5, 6, 9, 10} : You can enforce the text position on the video (0=center, 1=left, 2=right, 4=top, 8=bottom; you can also use combinations of these values, eg 6 = top-right) default value: -1

Font

  • rss-opacity <integer [0 .. 255]> : Opacity (inverse of transparency) of overlay text. 0 = transparent, 255 = totally opaque default value: 255
  • rss-color <integer> {0x00000000, 0x00808080, 0x00C0C0C0, 0x00FFFFFF, 0x00800000, 0x00FF0000, 0x00FF00FF, 0x00FFFF00, 0x00808000, 0x00008000, 0x00008080, 0x0000FF00, 0x00800080, 0x00000080, 0x000000FF, 0x0000FFFF} : Color(key) of the text that will be rendered on the video. This must be an hexadecimal (like HTML colors). The first two chars are for red, then green, then blue default value: 0xFFFFFF
  • rss-size <integer [0 .. 4096]> : Font size, in pixels. Default is 0 (use default font size) default value: 0

Misc

  • rss-speed <integer> : Speed of the RSS/Atom feeds in µs (bigger is slower) default value: 100000
  • rss-length <integer> : Maximum number of characters displayed on the screen default value: 60
  • rss-ttl <integer> : Time in seconds between each feed refresh of the feeds. 0 means that the feeds are never updated. 1800 seconds is 30 minutes default value: 1800
  • rss-images <boolean> : Display feed images if available default value: enabled
  • rss-title <integer> {default_title, hide_title, prepend_title, scroll_title} : Title display mode. 0 is hidden if the feed has an image and feed images are enabled, 1 is always visible, 2 is scroll with feed default value: default_title

Examples

Example command line use (VLC 0.9.0 and above): (untested with 3.x.x)

% vlc somevideo.avi --sub-filter=rss --rss-urls="http://news.google.com/news?ned=us&topic=h&output=rss"

Source code

See also

Appendix

Colour key for --rss-color
Sample Hex code Colour
0x00000000 Black
0x00808080 Gray
0x00C0C0C0 Silver
0x00FFFFFF White
0x00800000 Maroon
0x00FF0000 Red
0x00FF00FF Fuchsia
0x00FFFF00 Yellow
0x00808000 Olive
0x00008000 Green
0x00008080 Teal
0x0000FF00 Lime
0x00800080 Purple
0x00000080 Navy
0x000000FF Blue
0x0000FFFF Aqua

For --rss-position:

Integer alignment mapping
Integer Alignment Comment
0 Center
1 Left
2 Right
4 Top
8 Bottom
5 Top-Left 4 + 1
6 Top-Right 4 + 2
9 Bottom-Left 8 + 1
10 Bottom-Right 8 + 2
3 n/a contradictory
7 n/a contradictory
This page is part of official VLC media player Documentation (User GuideStreaming HowToHacker GuideModules)
Please read the Documentation Editing Guidelines before you edit the documentation
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.