doc/integration/feeds.texi

   1 @node Feeds
   2 @cindex Web feeds integration
   3 @cindex RSS feeds integration
   4 @cindex Atom feeds integration
   5 @section Integration with Web feeds
   6
   7 @pindex r2e
   8 RSS and Atom feeds could be collected using
   9 @url{https://github.com/wking/rss2email, rss2email} program. It converts
  10 all incoming feed entries to email messages. Read about how to integrate
  11 @ref{Postfix}/@ref{Exim} with email. @command{rss2email} could be run in
  12 a cron, to collect feeds without any user interaction. Also this program
  13 supports ETags and won't pollute the channel if remote server supports
  14 them too.
  15
  16 After installing @command{rss2email}, create configuration file:
  17
  18 @example
  19 $ r2e new rss-robot@@address.com
  20 @end example
  21
  22 and add feeds you want to retrieve:
  23
  24 @example
  25 $ r2e add http://www.nncpgo.org/download/releases.atom
  26 @end example
  27
  28 and run the process:
  29
  30 @example
  31 $ r2e run
  32 @end example
  33
  34 @pindex feeder
  35 But it is more flexible and advisable to use use
  36 @url{https://www.feeder.stargrave.org/, feeder} (NNCP's author creation)
  37 that also transforms feed entries to Maildir email messages. Incoming
  38 entries are placed in @file{new/} Maildir directories, so you can easily
  39 send all of them:
  40
  41 @example
  42 % tar cf - **/new/*(.) | zstdmt | nncp-file - remote.node:feeds-`date -Iseconds`.tar.zst
  43 % feeder/dir/contrib/feeds-oldenize.zsh
  44 @end example
  45
  46 Unlike @command{r2e}, @command{feeder} has also
  47 @url{http://www.feeder.stargrave.org/Enclosures.html, enclosures} and
  48 @url{http://www.feeder.stargrave.org/WARCs.html, WARCs} downloading
  49 capabilities, that are also stored as a files on the disk.