Matrix.org

From Meta, a Wikimedia project coordination wiki
(Redirected from User:GWicke/Matrix.org)
Jump to: navigation, search

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[edit]

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[edit]

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[edit]

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.