\input texinfo
@settitle feeder

@copying
Copyright @copyright{} 2022-2024 @email{stargrave@@stargrave.org, Sergey Matveev}
@end copying

@node Top
@top feeder

@command{feeder} is a free software newsfeeds aggregator.
I wrote it solely for my personal needs, so currently probably there is
some hard-code in the scripts.

My experience was heavily based on @url{https://newsboat.org/, Newsboat}
reader, that unfortunately was rewritten on Rust, so I had to use its
old version. I also saw
@url{https://codemadness.org/git/sfeed/file/README.html, sfeed} project,
that tries to reuse many already existing tools (like @command{curl}),
be @url{https://suckless.org/philosophy/, suckless} and Unix-friendly,
but failed somewhere during the try, and asked myself if it is really so
hard to make that kind of software. It was written in less than a day,
completely replacing Newsboat, with much higher performance and great
flexibility.

Its architecture is very simple:

@itemize
@item @url{https://curl.se/, cURL} is used to download feed URLs.
@item @url{https://go.dev/, Go}-written @command{feed2mdir} utility
    parses and converts feed's items to mail messages stored inside
    @url{https://en.wikipedia.org/wiki/Maildir, Maildir}.
@item Automatically generated @url{http://www.mutt.org/, Mutt} source
    file contains convenient options and human-readable mailboxes list.
@item @url{https://www.gnu.org/software/parallel/, GNU parallel} for
    parallel invocation of download/parsing jobs.
@item @url{https://www.djcbsoftware.nl/code/mu/, mu} utilities perform
    indexing and searching among the messages. Of course it would be
    trivial to use @url{https://www.lesbonscomptes.com/recoll/, recoll}
    or @url{https://notmuchmail.org/, notmuch} instead, if you need that.
@item Bunch of optional @url{https://www.zsh.org/, Zsh} helper scripts.
@end itemize

But of course it has its price: original feed data, its Base64-encoded
copy in mailbox and another copy in @command{mu}'s Xapian database.

@insertcopying

@include storage.texi
@include mail.texi
@include usage/index.texi

@bye