Introduction

pyferea is my solution to this email that I posted to the debian-users list in 2011. I was fed up with there being no sane RSS reader in existance that could just render some RSS entries in a fast and simple fashion.

Quick Start

Create a feeds.yaml (you can copy feeds.yaml.example) and then run:

$ python pyferea.py

Naming

It is called pyferea (python feed reader) for now as I was inspired by the layout of liferea (linux feed reader). I guess I'm just too lazy to come up with another name but suggestions are welcome. Pyferea is just the first thing that sprang to my mind when I had to give the sourcecode directory a name and I didnt change it since.

Purpose

I might really overlook something out there but everytime I checked there was no sane RSS feed reader out there that would please me. I did not think that I would require much. Just three panes for feeds, entries and content, keeping record of unread entries and rendering content in a browser. Liferea came close but was poisoned by feature bloat (as many others... especially gnome dependencies) and major slowness. Pyferea does just what I want, is simple, DE agnostic (uses python and gtk) and fits in about 1000 lines of code.

Bugs

Pyferea as it is now is enough for my daily use but there are still some issues that need to be fixed: the back/forward functionality of the browser must be fixed (i seldomly use it), the date/time in the entry panel doesnt update correctly over time (i can live with it for now) and the text in the addressbar, title and tabtitle must be synced. I will fix that once I feel like it. If anybody feels inclined to do so, then patches are welcome.

Dependencies

feeds.yaml

It is a yaml dictionary with rss/atom feeds as keys and subdictionaries as values. For each entry they store the category a feed is in and if the link given in a feed entry should be loaded instead of the feed text.

Example:

http://planet.debian.org/rss20.xml:
  category: "IT news"
  loadlink: False
http://slashdot.org/slashdot.rss:
  category: "IT news"
  loadlink: True

Cookies

Cookies are kept in cookies.txt and are automatically accepted

ythtml5.js

A javascript that I load upon each pageload to convert youtube videos into their html5 versions so that the webkit plugin can render them even withoutme having flash.