NAME

sfeed —

RSS and Atom parser

SYNOPSIS

sfeed [baseurl]

DESCRIPTION

sfeed reads RSS or Atom feed data (XML) from stdin. It writes the feed data in a TAB-separated format to stdout. If the baseurl argument is a valid absolute URL then the relative links or enclosures will be made an absolute URL.

TAB-SEPARATED FORMAT FIELDS

The items are output per line in a TAB-separated format.

For the fields title, id and author each whitespace character is replaced by a SPACE character. Control characters are removed.

The content field can contain newlines and these are escaped. TABs, newlines and '\' are escaped with '\', so it becomes: '\t', '\n' and '\\'. Other whitespace characters except spaces are removed. Control characters are removed.

The order and content of the fields are:

1. timestamp: UNIX timestamp in UTC+0, empty if missing or on parse failure.
2. title: Title text, HTML code in titles is ignored and is treated as plain-text.
3. link: Link
4. content: Content, can have plain-text or HTML code depending on the content-type field.
5. content-type: "html" or "plain" if it has content.
6. id: RSS item GUID or Atom id.
7. author: Item author.
8. enclosure: Item, first enclosure.
9. category: Item, categories, multiple values are separated by |.

EXIT STATUS

The sfeed utility exits 0 on success, and >0 if an error occurs.

EXAMPLES

curl -s 'https://codemadness.org/atom.xml' | sfeed

AUTHORS

Hiltjo Posthuma <hiltjo@codemadness.org>

CAVEATS

If a timezone for the timestamp field is not in the RFC822 or RFC3339 format it is not supported and the timezone is interpreted as UTC+0.