Minimal RSS/Atom feed reader.
Go to file
2022-04-09 17:45:48 -04:00
.gitignore Initial commit 2021-08-02 11:41:15 -04:00
config.def.h Remove feed tags 2021-09-22 19:06:30 -04:00
LICENSE Initial commit 2021-08-02 11:41:15 -04:00
Makefile Change default install location 2021-08-24 15:27:54 -04:00
minrss.c Improve documentation 2021-09-22 18:50:42 -04:00
net.c Improve documentation 2021-09-22 18:50:42 -04:00
net.h Reformat code with consistent style 2021-08-06 14:32:04 -04:00
README Clarify Atom support in README 2022-04-09 17:45:48 -04:00
util.c Reformat code with consistent style 2021-08-06 14:32:04 -04:00
util.h Initial commit 2021-08-02 11:41:15 -04:00
xml.c Remove unused article attributes 2021-10-22 17:14:09 -04:00
xml.h Remove unused article attributes 2021-10-22 17:14:09 -04:00

MinRSS
======
MinRSS is an RSS/Atom feed reader for Linux inspired by suckless.org's
IRC clients ii and sic. Instead of presenting articles as entries
in a menu, it saves them as files in folders.

rss
|--news
|  |--article1
|  `--article2
`--blog
  |--post
  `--other_post

Requirements
------------
You need libcurl and libxml2 to compile MinRSS.

Installation
------------
Run this command to build MinRSS:

	make clean install

This will install the binary to ~/.local/bin. Make sure that this directory is
in your $PATH.

If you need to change this, set the PREFIX variable in Makefile.

Configuration
-------------
MinRSS is configured via the config.h file, which you can create by
either compiling MinRSS for the first time or copying config.def.h
to it. To save your changes, recompile MinRSS.

Using MinRSS
------------
Make a directory to store your RSS feeds, then cd into it. Then, enter 
the minrss command to download the RSS feeds. Your feeds will be 
available as folders in your current working directory.

Compatibility
-------------
This program is designed to work on Linux, but it should be possible
to make it run on other operating systems. If you can do that
successfully, please contact me about it.

Note that if you use MinRSS on different systems, it will be possible for
attackers to write malicious filenames, so you should rewrite sanitize()
accordingly.