RSS reader

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.