How to use matrix.org and vector.im as an IRC client

MATRIX.md

How to use matrix.org and vector.im as an IRC client

How to Join an IRC Channel on matrix.org

Join the room #freenode_<#channel>:matrix.org, replacing <#channel> with the name of the IRC channel. For example, in order to join the #prometheus IRC channel, join the room #freenode_#prometheus:matrix.org on matrix.org.

In vector.im, rooms can be joined with the directory symbol on the bottom left.

How to Use a Freenode-Registered Nickname on matrix.org

As described here: If you have a Freenode-registered nickname and want to use it from Matrix, you can do it like this:

1. Leave with your nick on IRC
2. On Matrix, open a new chat (with vector.im this is the "+" sign on the bottom left)
3. Invite @appservice-irc:matrix.org to the new chat
4. Say !nick <yournick>
5. A request for new chat with NickServ will pop up
6. Accept it and identify yourself with your Freenode password (identify <password>)

Voila, you'll be using your Freenode-registered nick through Matrix, being able to use multiple devices simultaneously with shared history and all!

How to Start Private IRC Chats, like /msg or /query

1. On Matrix, open a new chat (with vector.im this is the "+" sign on the bottom left)
2. Invite @freenode_<nick>:matrix.org to the new chat (replace <nick> with the nick name. For example, to start a chat with NickServ, invite @freenode_NickServ:matrix.org)

This works for nicks that are known to matrix.org, i.e. if the nick has never joined an IRC channel that was bridged to matrix it won't work.

If you get the error: err_banonchan then you can use the solution here: matrix-org/matrix-appservice-irc#475 (comment)

Authentification with the IRC network can be done automatically during login. Open a private chat with appservice:

!username
!storepass irc.libera.chat

More details here: https://meta.wikimedia.org/wiki/Matrix.org#Authenticating_with_LiberaChat

To use Libera Chat use @channel:libera.chat