Skip to content

Web RSS aggregator and reader compatible with the Fever API

License

Notifications You must be signed in to change notification settings

passiomatic/coldsweat

Folders and files

NameName
Last commit message
Last commit date

Latest commit

6e20756 · Nov 5, 2016
Nov 5, 2016
Jun 21, 2013
Jun 16, 2013
May 29, 2016
Aug 3, 2016
Aug 3, 2016
Aug 3, 2016
Jun 23, 2013
Aug 3, 2016
Nov 5, 2016
Aug 3, 2016
Aug 3, 2016
Mar 7, 2015
Dec 5, 2015
Aug 3, 2016
Aug 3, 2016

Repository files navigation

Coldsweat 0.9.7

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.