File	Date	Author	Commit
applications	2011-07-29	Bidossessi Sodonon	[97e6e7] * BRss installs and runs on Fedora 15 using pyt...
bin	2011-07-29	Bidossessi Sodonon	[97e6e7] * BRss installs and runs on Fedora 15 using pyt...
brss	2014-02-10	Bidossessi Sodonon	[d5cb28] fixed a few bugs, enabled drag and drop
icons	2014-02-10	Bidossessi Sodonon	[d5cb28] fixed a few bugs, enabled drag and drop
pixmaps	2014-02-10	Bidossessi Sodonon	[d5cb28] fixed a few bugs, enabled drag and drop
po	2011-07-29	Bidossessi Sodonon	[97e6e7] * BRss installs and runs on Fedora 15 using pyt...
schemas	2011-07-29	Bidossessi Sodonon	[97e6e7] * BRss installs and runs on Fedora 15 using pyt...
CHANGES.txt	2011-07-28	Bidossessi Sodonon	[a2a90e] trying to make brss croos-distro
LICENSE.txt	2011-07-07	Bidossessi Sodonon	[0b1501] * fixed critical bug in feed update mechanism
MANIFEST.in	2011-07-31	Bidossessi Sodonon	[9fd78b] * ready to install using setup.py install. test...
README.txt	2011-10-06	Bidossessi Sodonon	[3d190c] Updated to reflect API changes in python-gobject
setup.cfg	2011-07-28	Bidossessi Sodonon	[a2a90e] trying to make brss croos-distro
setup.py	2011-07-31	Bidossessi Sodonon	[14f0a4] * terrible omission in install paths

Read Me

=======
 brss
=======

BRss is an 'offline' RSS reader written in Python.
It is a complete rewrite of another python RSS reader (Naufrago!),
based on the concept of service/client. It uses the dbus library to 
enable communication between the service and clients.

Features:
---------

BRss consists of two applications:

1. brss-engine
brss-engine is a dbus service. Its main features are:
    - periodically downloads feed articles, with their images
    - notify on updates
    - transparently replaces remote image tags on article request.
    - search articles

2. brss-reader
brss-reader is a GTK+ client for brss-engine.
    - Connects to brss-engine
    - Keyboard feed and article navigation (à la Thunderbird)
    - full-screen article viewing
    - Article search engine


INSTALL:
--------
Reminder: BRss is still "alpha" software. Use at your own risks.

BRss requires the following python modules to run.

python-gobject
python-feedparser
python-sqlite3
python-dbus

How to install this modules may vary depending on your distribution.
In Archlinux run the following command as root:

# pacman -S dbus-python python2-gobject python2-feedparser python-pysqlite gtk3 \
    libwebkit3 libnotify gcc gettext glib2

1. Extract the archive

$ tar zxf brss-0.8.16.tar.gz
$ cd brss-0.8.16

2. Install

$ sudo python setup.py install

3. Compile the schema folder

$ sudo glib-compile-schemas /usr/share/glib-2.0/schemas/

TODO:
-----

The following are planned, in no particular order:

    - Provide a proper install script.
    - Documentation
    - Gnome3 design guidelines compliance
    - Better logo and pixmaps
    - CLI interface
    - DnD feed recategorizing