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.
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 will be my personal take at consuming feeds today.
- 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
See setup page.
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
A few changes have been made to the configuration options:
- A new config option named
connection_url
replacesengine
,database
,hostname
,username
andpassword
options - Config option
error_threshold
is now calledmax_errors
- Config option
multiprocessing
has been replaced byprocesses
. Assigning a value of 0 disables multiprocessing - Log config options
format
anddatefmt
have been removed. Please remove them from youretc/config
file if Coldsweat raises aConfigParser.InterpolationMissingOptionError
exception on startup.
To make the configuration code more robust almost all options have now a default value so you don't necessary need to adjust the values listed above. Take a look at etc/config-sample
for further information.
Coldsweat now uses the user e-mail instead of username to authorize clients, like Fever API dictates. This means that while configuring your Fever client it is required to specify an e-mail address and password to successully finish to authorization process.
The commands update
and refresh
are now respectively aliases of upgrade
and fetch
. Older command names will most likely dropped with the 1.0.0 release.
- 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.