elo (ziomal greetings in Poland) , this is README for PyRSS.

WTF is PyRSS?

PyRSS is component for jabber servers (works with jabberd1.4, propably works also with jabberd2). PyRSS fetch rss and notify registered users.


* Requirements:

PyRSS needs to work:
	pyxmpp - http://jabberstudio.org/projects/pyxmpp (version 0.5 is too old, you need newer one,
		actually you should get svn version).
	feedparser.py - http://diveintomark.org/projects/feed_parser/ (tested with 3.0 beta 22).
	MySQL - PyRSS uses python db api 2.0, so change to another database is very easy...

INSTALL:

Make sure, that you have got installed feedparses and pyxmpp. Then you can create database:

$ echo "CREATE DATABASE pyrss;" |mysql -u user -p
$ cat pyrss.sql | mysql -u user -p pyrss
$ cp pyrss.xml /etc/jabber/.

MySQLdb works very strange. Maybe you will be need similar my.cnf:
wait_timeout    = 60
max_connections = 800


Edit /etc/jabber/pyrss.xml to modify it to your settings (put your jid as admin jid).

THEN:

* To work with jabberd 1.4 you have to put following lines in <browse> section:

        <headline type="rss" jid="rss.localhost" name="RSS reader">
                <ns>jabber:iq:register</ns>
        </headline>

and these in service section:

  <service id="rsslinker">
    <host>rss.localhost</host>
    <accept>
      <ip>127.0.0.1</ip>
      <port>31516</port>
      <secret>pazzwuda</secret>
    </accept>
  </service>

Of course, you have to change <secret>, <host> values ;)


To start pyrss, put ,,python start.py''.

Restart jabber server. 

You should also check Discovery Service! 
For example, to be notifed about slashdot news:

add slashdot http://slashdot.org/slashdot.rdf 45

(third parametr is optional, it sets how often rss should be fetch, in minutes. slashdot doesn't like often fetchs ;).

then your user could add slashdot@rss.yourserver contact to their roster...

Enjoy!

-- 
Rafal Zawadzki
e-mail/jid: bluszcz@jabberpl.org

