Matrix.org

Matrix is a decentralized, open source messaging system that integrates well with IRC. It provides modern features like a web interface, easy catch-up on missed conversation (without the need to run a bouncer), read-message tracking, and end-to-end encryption (implementation in progress). It even supports voice and video calling.

Getting started with Riot

The easiest way to get started with Matrix is using the Riot web interface. To register, create a free Matrix account at https://riot.im/app/.

If you have a bouncer, be sure to disconnect it before setting up Riot/Matrix. If you are using IRCCloud, signing out is not enough. You'll need to click on the gear icon next to the "Freenode" heading in the upper-right corner, and choose "Disconnect". Otherwise, the system will think your nick is taken, and Matrix will automatically connect you using a variation on your nick.

Connecting to freenode IRC channels

Configuring your IRC nick:

• Open a chat with @appservice-irc:matrix.org
  • Use the + icon in the bottom left to create an empty room
  • Then use the text box in the upper right to invite @appservice-irc:matrix.org into the room.
• In the "type a message" area at the bottom, enter !nick <yournick>

Connect to freenode channels:

Freenode IRC channels are reachable by connecting to a channel called #freenode_#<channel>:matrix.org. For example, to connect to #mediawiki, start a matrix chat with #freenode_#mediawiki:matrix.org.

• Click on the folder icon in the lower left to bring up the room directory
• Enter the entire channel you want to connect to, such as #freenode_#mediawiki:matrix.org
• When prompted, choose to "join" the channel

The riot.im web interface hides some of that, so you can instead:

• Click on the folder icon in the lower left to bring up the room directory
• In the dropdown on the right, choose Freenode
• Enter some of the channel name, like mediawiki and wait for the list to populate below
• Click on the channel in the list
• When prompted, choose to "join" the channel
• NOTE: Private channels will not be listed--you'll need to get someone already in the channel to invite you

Authenticating with freenode:

After connecting to a channel on freenode, you should get a chat invite from NickServ. If you don't, you can initiate a chat with NickServ by clicking on the person icon ("Start Chat") in the bottom-left) and entering: @freenode_NickServ:matrix.org. Once you are in a chat with NickServ, to sign in, accept the chat invite & type: identify <user> <password>

Appservice 0.7 also added the option to save the IRC password. This avoids the need to re-authenticate manually, which is especially useful if you frequently use private channels. To save your password, go to the appservice chat, and type !storepass chat.freenode.net <yourpass>. Note: this seems to be necessary to connect to the #wikimedia-staff and certain password protected channels.

Other

If you need further help with your Freenode connection, try issuing the command !help in your chat with @appservice-irc:matrix.org. If that doesn't work, you can try asking for help in the #irc:matrix.org room, where people who maintain the IRC bridge code hang out.