Minimal RSS/Atom feed reader.
Go to file
2021-08-11 17:22:07 -04:00
.gitignore Initial commit 2021-08-02 11:41:15 -04:00
config.def.h Format RSS items as HTML files 2021-08-11 17:22:07 -04:00
LICENSE Initial commit 2021-08-02 11:41:15 -04:00
Makefile Update Makefile 2021-08-05 20:18:48 -04:00
minrss.c Format RSS items as HTML files 2021-08-11 17:22:07 -04:00
net.c Reformat code with consistent style 2021-08-06 14:32:04 -04:00
net.h Reformat code with consistent style 2021-08-06 14:32:04 -04:00
README Change filename sanitization 2021-08-04 16:46: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 Reformat code with consistent style 2021-08-06 14:32:04 -04:00
xml.h Reformat code with consistent style 2021-08-06 14:32:04 -04:00

MinRSS
======
MinRSS (minimal RSS) is an RSS feed reader for Linux inspired by suckless.org's
IRC clients ii and sic. Instead of presenting RSS 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 as root to build MinRSS:

	make clean install

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.