https://github.com/132ikl/minirss

A minuscule RSS notifier
https://github.com/132ikl/minirss

Last synced: 3 months ago
JSON representation

A minuscule RSS notifier

• Host: GitHub
• URL: https://github.com/132ikl/minirss
• Owner: 132ikl
• License: gpl-3.0
• Created: 2020-06-29T02:23:25.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2021-11-30T05:45:05.000Z (about 3 years ago)
• Last Synced: 2024-02-17T11:32:09.534Z (12 months ago)
• Language: Python
• Homepage:
• Size: 24.4 KB
• Stars: 5
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# minirss: a minuscule RSS notifier

minirss is a tiny Python script to help you keep track of your RSS feeds. Whenever one of your feeds updates, you'll get a notification. Additionally, if you use dunst, simply middle click (or whatever your configured action button is) and you will be taken to the link.

## Installation

On Arch Linux, minirss can be installed using its [AUR package](https://aur.archlinux.org/packages/minirss-git/).

Dependencies (probably installable as `python-` in your distribution):

* appdirs

* requests

* feedparser

You can also manually install minirss through this process:

```

sudo cp minirss /usr/bin/minirss

cp minirss ~/.config/systemd/user/

systemctl --user enable --now minirss

```

## Config

minirss uses two files: a config file (default in $XDG_CONFIG_HOME) and a storage file (default in $XDG_DATA_HOME). Each line has three `|` separate fields: name, url, and (optional) options field:

```

my cool display name|https://link-to-cool-rss-feed.com/feed.xml

cool feed with options|https://link-to-cool-rss-feed.com/feed.xml|options

```

minirss will also always use the most updated config, no need to restart.

## Feed Options

* `fullhistory`

    - Use this for non-chronological feeds (ie. the first entry in the feed is not the latest)