===========================================================================
dbagg, a personal news aggregator
l.m.orchard <deus_x@pobox.com>
http://www.decafbad.com/twiki/bin/view/Main/DbAgg
===========================================================================

Welcome to my experiment in writing my own aggregator in Python. 
Be warned that things are in an interesting, yet barely functional, state.

You're going to need the following prerequisites:

   * Twisted, from CVS - http://www.twisted-matrix.com
   * pysqlite - http://pysqlite.sourceforge.net/
   * sqlite (optional) - http://www.sqlite.org

Once you have those installed, you'll need to create a new database for
your aggregator.  Two ways to do this from the project directory:

1) cd data; cp _agg_blank agg
2) sqlite data/agg < sql/sqlite.sql; sqlite data/agg < sql/sources.sql

The first method simply uses a pre-created binary sqlite database that
I created.  The second method creates a fresh database from the latest
SQL schema.  The difference between the two is that the second method
is likely to be most up to date, but requires that you have sqlite
available.

After this, you should be able to start the aggregator with:

    python bin/dbagg.py

Then, to view news, point your browser at:

    http://localhost:8088

Also, a twisted admin console is available via telnet on port 4040.

Otherwise, poke around at things.  At present, you'll likely need
to use the sqlite tool to add/remove RSS sources from the database.

That's all for now, have fun!