the Universal Aggregator -
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Ryan 3d7a52338d remove the scrapers 3 years ago
doc Scrapers overhaul 6 years ago
ggs bugfix 7 years ago
maildir-put maildir-put: change redis cache storage format 7 years ago
rss2json initial import 10 years ago
scrapers scraper-yggtorrent: bugfix 6 years ago
ua-inline ua-inline: use attachment for images 8 years ago
ua-proxify new filter: ua-proxify 8 years ago
weboobmsg2json Scrapers overhaul 6 years ago
.gitignore Scrapers overhaul 6 years ago
COPYING initial import 10 years ago
Makefile remove the scrapers 3 years ago Scrapers overhaul 6 years ago
ggsrc.example initial import 10 years ago

The Universal Aggregator

This is a set of tools to aggregate all your information into your maildir. Each tool can be used separately ; you can find a more complete description in their respective folder.

  • ggs is a software which runs commands periodically
  • maildir-put reads a set of messages from its standard input and puts them in a maildir
  • rss2json transforms any RSS/Atom feed into a set of messages that maildir-put can process
  • You can write your own producers (scrapers) for maildir-put ; some are already provided in the scrapers/ directory.
  • You can also put filters, like ua-inline or ua-proxify.


ggs [path-to-configuration-file]


  • Go
  • libxml
  • jq
  • For additional scrapers: scrapy, python 3 and nodejs


make && sudo make install


See the ggs documentation for more information. Here is an sample configuration file, which puts some feeds into Fun and Geek folders, some new chapters notification from mangareader into Entertainment, and my Github personal feed into inbox:


rss() {
	command 2000 "rss2json \"$1\" | ua-inline | maildir-put -root $HOME/Maildir-feeds -folder \"$2\""

mangareader() {
	command 2000 "ua-scraper-mangareader -a name=$1 | "\
		"maildir-put -root $HOME/Maildir-feeds -folder Entertainment"

rss Fun
rss Fun
rss Fun

rss Geek
rss Geek

mangareader naruto
mangareader bleach
mangareader gantz

rss ""

Weboob compatibility

You can use weboob modules used by boobmsg to generate messages. Configure the modules using boobmsg, and use weboobmsg2json [module-name] to generate messages. [module-name] can be found in ~/.config/weboob/backends.