44 lines
1.2 KiB
Markdown
44 lines
1.2 KiB
Markdown
# spiderss
|
|
|
|
|
|
|
|
__spiderss__ is a plaintext RSS reader / crawler.
|
|
Feeds are parsed the articles are stored as Markdown files on the filesystem.
|
|
|
|
## Why?
|
|
|
|
Because plaintext is God.
|
|
|
|
## How can I read the articles?
|
|
|
|
Use your favourite Markdown viewer, or just the console.
|
|
__spiderss__ integrates nice with the [ranger](https://github.com/ranger/ranger) filemanager to browse categories.
|
|
|
|
## How does it work?
|
|
|
|
Edit the `config.toml` file to your liking and run the script.
|
|
The script creates a folder structure the following way:
|
|
|
|
```
|
|
base_directory
|
|
| - category
|
|
| - feedname
|
|
| - new
|
|
| - read
|
|
| - another feedname
|
|
| - new
|
|
| - read
|
|
| - another category
|
|
| - a third feedname
|
|
| - new
|
|
| - read
|
|
| - loved
|
|
|
|
Every feed gets a `new` and a `read` subfolder.
|
|
Article files are stored in the `new` folder.
|
|
Move them to the `read` folder if you're done reading them.
|
|
You can do this easily e.g. by setting a keybinding in ranger.
|
|
|
|
A special folder, called `loved`, is created on startup.
|
|
It is intended for articles, you want to keep.
|
|
Articles inside are never deleted, even if they expire the _max_age_.
|