Skip to content

Instantly share code, notes, and snippets.

@fstab
Last active January 5, 2022 12:31
Show Gist options
  • Save fstab/ce805d3001600ac147b79d413668770d to your computer and use it in GitHub Desktop.
Save fstab/ce805d3001600ac147b79d413668770d to your computer and use it in GitHub Desktop.
How to use matrix.org and vector.im as an IRC client

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.

@f1ghter04
Copy link

I'm learning how to use this...very novice but intrigued. Need input.

@5chdn
Copy link

5chdn commented Dec 23, 2017

How to use matrix.org and vector.im as a freenode.net client

Fixed the title for you. :)

@bencejuhaasz
Copy link

inviting appservice does nothing, it just says its invited but it doesn't enter the room or gives any service

@oblitum
Copy link

oblitum commented Feb 10, 2018

This worked for me, but now, how do I take my nickname back to use in IRC? I've tried to send logout to nickserv from riot, and tried to identify myself in plain weechat again, I only get nickname is already in use, despite having logged out from all riot instances.

@oblitum
Copy link

oblitum commented Feb 11, 2018

OK. I had to NickServ ghost, release and regain my nick.

@Hi-Angel
Copy link

Hi-Angel commented Mar 2, 2018

It doesn't work. I enter #freenode_#kde-devel:matrix.org, and Riot says (it's a localized message though, I'm translating) Wrong address entered. Try using one of the following: Matrix ID, Matrix ID of a room, a email.

@axionl
Copy link

axionl commented Jun 7, 2018

For the NickServ, you can give a tip on how to use commands. Just use commands directly without /msg NickServ.

@colans
Copy link

colans commented Aug 29, 2018

I've got the registration set up, and am in a bunch of channels (have been for a while), but when trying to join a new one I get:

Could not join #example on 'chat.freenode.net': err_needreggednick

Nevermind; I needed to re-identify with my password. https://github.com/matrix-org/matrix-appservice-irc/wiki/End-user-FAQ#how-do-i-registeridentify-to-nickserv

@mairin
Copy link

mairin commented Sep 25, 2018

I get err_banonchan. Which chan?

@emdete
Copy link

emdete commented Sep 29, 2018

yes, i get a Failed to change nick: err_banonchan too, no clue what happens...

@toraritte
Copy link

How does one set operator powers in riot.im? Tried /msg (does not exist), /op user powers but no clue what the syntax is (and couldn't find the docs yet).

@freeman42x
Copy link

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

@alexxcons
Copy link

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

@CypherpunkSamurai
Copy link

To use Libera Chat use @channel:libera.chat

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment