rx - how to use the XMPP bridge

The XMPP bridge enables you to use IRC from an XMPP client. The bridge will act as a bouncer you can interact from XMPP, thus you will receive history while away by default.

Features

• History is recorded and sent via MUC MAM (configure your server to support it!)
• Native experience: IRC users show up as XMPP users and vice-versa
• Not annoying to IRC users

Getting started

You may connect to rx from XMPP by joining a channel hosted on rx from XMPP, like #support@rx.trans.vitali64.duckdns.org. The channel format is #channel@rx.trans.vitali64.duckdns.org.
The connection is closed if you leave all IRC channels.
To receive presence info from the bridge, add rx.trans.vitali64.duckdns.org to your XMPP Roster. The bridge will always accept roster requests.

How bridging is handled

There are various features XMPP has that IRC currently lacks. Usually those are 'translated' to IRC in various ways.

• Multiline messages are split into multiple messages (PRIVMSG)
• Files are sent as links
• Edits are sent as new messages (so don't abuse them or you might get into trouble!)

Unlike other bridges, the XMPP bridge does roughly return what gets sent to IRC, so what you will see in your XMPP will be what was sent to IRC.

Configuring the bridge

The XMPP bridge supports a wide variety of options, accessible via XMPP Ad-Hoc commands:

• disconnect-from-irc-server: Disconnect from rx
• get-irc-connection-info: Returns list of channels joined and connection status
• global-configure: Configure global channel settings
• Record history: Choose if history should be logged (default: True)
• Make all channels persistent: Stay joined to channels while disconnected from XMPP (default: True)
• server-configure: Configure IRC server connection settings
• Nickname: Nickname to use when connecting to the server (default: unset)
• After-connection IRC commands: Raw IRC commands to run automatically after connecting (default: unset)
• Realname: Gecos/realname to be used (default: XMPP JID)

Known issues

• The XMPP bridge currently cannot identify to NickServ accounts
• Your JID will be shown to everyone else, either in the IRC realname/gecos or the ident

See also

For more documentation about the bridge software, see https://doc.biboumi.louiz.org/user.html

Need help?

We're available in the xmpp:#support@rx.trans.vitali64.duckdns.org?join channel for any questions that may arise.