Tree [a2d8f2] malgab tip /
History



File Date Author Commit
debian 2008-03-23 rubin rubin [a2d8f2] Initial import of jabber<->ircd gateway from ja...
ChangeLog 2008-03-23 rubin rubin [a2d8f2] Initial import of jabber<->ircd gateway from ja...
IRC-Transport-Howtouse.html 2008-03-23 rubin rubin [a2d8f2] Initial import of jabber<->ircd gateway from ja...
README.txt 2008-03-23 rubin rubin [a2d8f2] Initial import of jabber<->ircd gateway from ja...
irc.py 2008-03-23 rubin rubin [a2d8f2] Initial import of jabber<->ircd gateway from ja...
jep0133.py 2008-03-23 rubin rubin [a2d8f2] Initial import of jabber<->ircd gateway from ja...
transport.ini 2008-03-23 rubin rubin [a2d8f2] Initial import of jabber<->ircd gateway from ja...
xmpp-irc 2008-03-23 rubin rubin [a2d8f2] Initial import of jabber<->ircd gateway from ja...

Read Me

XMPP IRC-Transport Readme.
==========================


Installing the transport:
-------------------------

To install the transport you need a copy of the xmpppy (by Alexey Nezhdanov) library on your system and a copy of the irclib (by Joel Rosdahl). You can find both of these at the following addresses:

http://xmpppy.sourceforge.net
http://python-irclib.sourceforge.net

To make the irclib library integrate with the transport more effectively you need to patch it with the supplied diff file: irclib.py.diff.  (patch <irclib.py.diff works for me). This allows the external select function without needing lambda functions. This is required for the transport to operate (update: not needed since python-irclib v0.4.4).

Configure the Transport:
------------------------

To configure the transport you need to modify your jabber server configuration to expose the irc-transport to users. The transport itself has a configuration file which contains the following:

[transport]
Server: name.of.jabber.server
Hostname: name.of.irc.transport
Port: portnumber
Secret: sharedsecret
LocalAddress: ip-address-for-irc-connections
ServerType: jabberd2|someother
Charset: 8-bit charset to use when not UTF-8 encoded from network (all traffic out to irc is encoded as this type.) e.g. koi8-r shift-jis or gb2313

The default Python Encoding:
----------------------------

Some people may have set the python site.py encoding to something other than ascii. The transport relies on this being a non-unicode value, if you have set this to utf-8 it may not work.

Thanks to:
----------

The Jabber.org.uk crew who let me abuse their server while doing testing.
Alexey Nezhadanov for his help and the library.
Joel Rosdhal for the irclib library.