README.md

rssd

Poll and execute command when there is a new rss item

There is still much to do, keep your eyes open

Installation

• Manually

  > git clone https://github.com/ssiyad/rssd
  > cd rssd
  > make
  > make install
  

• From AUR

  > git clone https://aur.archlinux.org/rssd.git
  > cd rssd
  > makepkg -si
  

  or using your favorite AUR helper

  yay -S rssd
  

• or download a release, and manually copy executable into $PATH

Usage

Config

Default location is $XDG_CONFIG_HOME/rssd/config.json but could be overridden with --config

> rssd --config ./cfg/cfg.json

Adding a feed

> rssd add-feed "https://ssiyad.com/blog/index.xml"

Listing current feeds

> rssd list-feed
+-------+--------------------------------+-----------------------------------+
| INDEX |              FEED              |               LAST                |
+-------+--------------------------------+-----------------------------------+
|     0 | http://rss.art19.com/the-daily | https://www.nytimes.com/the-daily |
+-------+--------------------------------+-----------------------------------+

Removing a feed

> rssd remove-feed 0
removed:  https://www.twentyfournews.com/feed

Setting the command to execute

> rssd set-exec *command or /path/to/script*

Examples

• Desktop notifications

  > rssd set-exec "notify-send '&title' '&item_title'"
  

• Telegram bot

  > rssd set-exec "curl https://api.telegram.org/bot\$BOT_TOKEN/sendMessage?chat_id=\$TG_CHAT&text=&item_title"
  

Running rssd

• using systemd

  > systemctl --user enable rssd.timer
  > systemctl --user start rssd.timer
  

  make install copy service and unit files into /usr/lib/systemd/user
• with standalone mode

  > rssd --standalone --interval 5
  

  --interval is in minutes and is used only when in standalone mode

Available placeholders

Placeholders need to be prefixed with &, like &item_title

title
desc
lang
item_title
item_link
item_pubDate
item_desc
item_authorName
item_authorEmail