Skip to content

RSS reader

Francesco edited this page Nov 1, 2017 · 16 revisions

T-UI beta 6.4 introduced a great new feature: RSS reader. The system is pretty easy to understand, but you'll need to know what an RSS feed is, and also how XML works.

Add an RSS feed

$ rss -add [ID] [update time in seconds] [URL]

  • [ID] -> a unique number that you'll use in future to set up your RSS feed
  • [update time in seconds] -> the number of time that will pass between two RSS feed updates
  • [URL] -> the URL of your RSS feed

Remove an RSS feed

$ rss -rm [ID]

Print the content of an RSS feed

$ rss -l [ID]

Include/exclude a new item

If include_rss_default is true:

$ rss -exclude_if_matches [ID] [regex]

will create a filter which will exclude every item where [regex] can find a match.

If include_rss_default is false:

will create a filter which will include only those items where [regex] can find a match.

Update settings

Temporary hide an RSS feed

$ rss -show [ID] [true/false]

If the second argument is false, you won't receive updates from that feed anymore, but it will be updated silently.

Change the update time

`$ rss -update_time [ID] [update time in seconds]

Change the base feed color

$ rss -color [ID] [color]

Change the feed format

$ rss -format [ID] [format]

Format guidelines

%[length][color]tag

The values between square brackets ([]) are optional, feel free to exclude them if you want. tag is the name of the feed tag that you want to show ("title", "description", ...)

For instance:

%[1000][teal]title --- %[50][#00ff00]description (%pubDate)

The tag link will show a direct link (if available) to the corresponding webpage.

Defining common formats

You can define a format that you will be able to use many times inside differents RSS feeds.

rss -add_format [ID] [format ID]

Then, you'll just need to set the [format] value of an RSS feed to the ID that you just created:

rss -format [ID] [format ID]

RSS commands

You can ask T-UI to execute a given command when a new RSS item contains a specified set of words.

rss -add_command [command ID] [IDs (separated by commas)] [regex] [cmd]

  • [command ID] -> a unique number identifying this specific command
  • [IDs] -> the IDs of the RSS feeds on which you will apply the following regex.
  • [regex] -> if this finds one or more matches inside a new item, [cmd] will be executed
  • [cmd] -> the command that will be executed

Important! [regex] can't contain spaces. What is after an eventual space would be considered as part of [cmd]. To overcome the problem, replace every space inside your regex with a \s (= any type of space in regexes [tab, newline, single space]) or change the cmd editing the file rss.xml.

Troubleshooting

Invalid publication date tag: file.xml

This happens when the RSS feed that you're trying to read uses a non-standard pubDate tag. To fix this, you just need to open the RSS feed in your browser. Then check what's the name of the tag that tells the publication date of the item.

For instance:

` /u/JavaReallySucks https://www.reddit.com/user/JavaReallySucks <table> <tr><td> <a href="https://www.reddit.com/r/gifs/comments/7a0qs5/transforming_werewolf_costume/"> <img src="https://b.thumbs.redditmedia.com/MZ84Smn7zPtz2diGcJNDCGIKb2on8N03QLoa_ohtULk.jpg" alt="Transforming werewolf costume" title="Transforming werewolf costume" /> </a> </td><td> &#32; submitted by &#32; <a href="https://www.reddit.com/user/JavaReallySucks"> /u/JavaReallySucks </a> &#32; to &#32; <a href="https://www.reddit.com/r/gifs/"> r/gifs </a> <br/> <span><a href="https://i.imgur.com/MheQHbM.gifv&quot;&gt;[link]&lt;/a&gt;&lt;/span> &#32; <span><a href="https://www.reddit.com/r/gifs/comments/7a0qs5/transforming_werewolf_costume/&quot;&gt;[comments]&lt;/a&gt;&lt;/span> </td></tr></table> t3_7a0qs5

2017-11-01T02:15:27+00:00 <title>Transforming werewolf costume</title> `

Clone this wiki locally