~jack/msrss

Merge/Scrub RSS feeds.
README.md: Remove '.'
README.md: Linkify feedsanitizer
Version bump: 0.21

clone

read-only
https://git.sr.ht/~jack/msrss
read/write
git@git.sr.ht:~jack/msrss

You can also use your local clone with git send-email.

msrss, Merge/Scrub RSS feeds

msrss is a command-line tool to clean and merge several RSS feeds into one.

It is inspired by tools such as feedsanitizer, but runs from a terminal so you're not depending on a web service. This readme used to include a link to a version of feedsanitizer running on Google App Engine, but that's vanished from the internet. Ironic.

NOTE: msrss is not under active development. I consider it feature-complete for my needs.

Examples

Clean up one feed:

$ msrss -o clean_feed.xml http://example.com/dodgy_feed.xml

Download my favourite webcomics' feeds and label the titles:

$ msrss -o webcomics.xml -t Webcomics -k '' \
    -l 'Darths & Droids' http://www.darthsanddroids.net/rss.xml \
    -l 'Irregular Webcomic!' http://irregularwebcomic.net/rss4.xml \
    -l 'xkcd' http://xkcd.com/rss.xml \
    -l 'Dr. McNinja' http://drmcninja.com/feed/

Building msrss

Nix

The easiest way to build msrss is with Nix. If you have Nix installed, run nix build; the binary will appear at ./result/bin/msrss.

If you want to install msrss into your environment, run nix-env -f . -i.

Other Systems

Prerequisites

Beyond fundamental build tools (like you'd get with debian's build-essential), you will need:

If you are building from git, you will also need:

  • autoconf
  • autoconf-archive
  • automake
Building

If you are building from git, first run autoreconf -i.

Building from source is the usual ./configure && make && sudo make install dance. msrss runs just fine without being installed by make install, if you don't want to install it.

Documentation

The full documentation for msrss is mantained as a man page. If you have installed msrss, you can read man msrss, otherwise you can run man ./msrss.1 in the git repo.

Hacking on msrss

The easiest way to get a development environment is to run nix-shell, otherwise you can install dependencies by hand. To build a tarball for a release, run make distcheck.