/coldsweat

Web RSS aggregator and reader compatible with the Fever API

Primary LanguagePythonMIT LicenseMIT

Coldsweat 0.9.8

Coldsweat is a Python web RSS aggregator and reader compatible with the Fever API. This means that you can connect Coldsweat to a variety of clients like Reeder for iOS or Mac OS X ReadKit app and use it to sync them together.

Screenshot

Motivation

I'm fed up of online services that are here today and gone tomorrow. After the Google Reader shutdown is clear to me that the less we rely on external services the more the data we care about are preserved. With this in mind I'm writing Coldsweat. It is my personal take at consuming feeds today.

Features

  • Web interface to read and add feeds
  • Compatible with existing Fever desktop and mobile clients
  • Multi-user support
  • Support for grouping of similar items
  • Multiprocessing for parallel feed fetching

Setup

See setup page.

Upgrading from a previous version

First, always make sure required third-party packages are up-to-date:

$ pip install -r requirements.txt

Second, make sure your database structure is up-to-date too:

$ python sweat.py upgrade

Notable changes from previous releases

  • Version 0.9.6: the etc/blacklist file is no longer available, please use the config scrubber_blacklist option instead.
  • Version 0.9.5: older commands update and refresh are now respectively aliases of upgrade and fetch. The former names will most likely dropped with the 1.0.0 release.

Technical underpinnings

  • Uses the industry standard Mark Pilgrim's Universal Feed Parser
  • Is WSGI compatible - currently tested under CGI, FastCGI and Passenger environments
  • Uses SQLite, PostgreSQL and MySQL databases
  • HTTP-friendly fetcher
  • Plugin system to easily extend fetcher capabilities
  • The Web reader has been tested with Safari 5+ and latest versions of Chrome and Firefox

Coldsweat started in July 2013 as a fork of Bottle Fever by Rui Carmo. By now I revised most of the code and tested the feed fetcher code with hundreds of Atom and RSS feeds.