rss-cli/README.md

91 lines
2.7 KiB
Markdown
Raw Permalink Normal View History

2021-07-23 23:18:13 +00:00
rss-cli
=======
A unix-inspired cli application for interacting with rss feeds
Build
=====
Depends on
----------
- rapidxml
- libcurl
To build
---------
`make all`
To install
-----------
`make install`
Usage
=====
2021-07-24 03:30:39 +00:00
`./bin/rss-cli --help`
2021-07-25 23:31:53 +00:00
Full help message
```
Usage: ./bin/rss-cli [-u FEED_URI] [CHANNEL FLAGS] [-i ITEM_INDEX] [ITEM FLAGS]
Options:
Required Options:
[-u, --uri] URI URI of the rss stream
2021-07-26 23:24:55 +00:00
Also accepts '-' to take input
from stdin (stops once a newline is reached)
2021-07-25 23:31:53 +00:00
Channel information:
[-t, --title] Get title of channel
[-l, --link] Get link to channel
[-d, --description] Get description of channel
2021-07-26 02:35:04 +00:00
[-L, --language] Get language code of channel
2021-07-25 23:31:53 +00:00
[-m, --webmaster] Get webMaster's email
[-c, --copyright] Get copyright
[-p, --pubdate] Get publishing date
2021-07-26 02:35:04 +00:00
[-e, --managingeditor] Get managing editor
2021-07-25 23:31:53 +00:00
[-g, --generator] Get generator of this feed
[-o, --docs] Get link to RSS documentation
[-w, --ttl] Get ttl, time that channel can be
cached before being updated
[-b, --builddate] Get last time the channel's
content changed
2021-07-26 02:35:04 +00:00
[-Q, --imageurl] Get channel image URL
[-I, --imagetitle] Get image title, same as ALT in html
[-E, --imagelink] Get link to site, image will act as a link
[-W, --imagewidth] Get width of image
[-H, --imageheight] Get height of image
[-D, --clouddomain] Get domain of feed update service
[-P, --cloudport] Get port of feed update service
[-A, --cloudpath] Get path to access for feed update service
[-R, --cloudregister] Get register procedure for feed update service
[-O, --cloudprotocol] Get protocol feed update service uses
2021-07-25 23:31:53 +00:00
[-i, --item] INDEX Provide index of item to display
If no index is provided, assume the first
item in the feed. All following flags will
be parsed as item options, till another
item is provided
Item options:
[-t, --title] Get title of item
[-l, --link] Get link
[-d, --description] Get description
[-a, --author] Get author
2021-07-26 02:35:04 +00:00
[-C, --category] Get category list
2021-07-25 23:31:53 +00:00
[-f, --comments] Get link to comments
2021-07-26 02:35:04 +00:00
[-G, --guid] Get GUID
2021-07-25 23:31:53 +00:00
[-p, --pubdate] Get publishing date
[-s, --source] Get source of item
2021-07-26 02:35:04 +00:00
[-U, --enclosureurl] Get enclosure URL
[-T, --enclosuretype] Get enclosure MIME type
[-K, --enclosurelength]Get enclosure length, in bytes
2021-07-25 23:31:53 +00:00
General options:
[-h, --help] Show this message
For more information, refer to the RSS 2.0 documentation
https://validator.w3.org/feed/docs/rss2.html
```