End user FAQ

Frequently asked questions by people who aren't running the IRC bridge by themselves.

What do I do if I already closed direct chat with the appservice?

Simply open it again, the appservice will join on invite. You can find it from user list of any bridged room, for example the freenode one is @appservice-irc:matrix.org.

How do I change my IRC side nick?

Say !nick YourNewNicknameHere in direct chat with the appservice user.

Why don't I get notifications from IRC pings?

Currently you have to add your IRC nick to your keywords. You can do this by opening Settings in Riot Web and under NOTIFICATIONS there is

Messages containing keywords

The word keywords is a link and by clicking it you can add/edit your keywords and add your IRC nick there to get pinged by it in the future.

How do I register/identify to NickServ?

Start by opening a direct chat with NickServ. It's generally @_<network>_NickServ:homeserver.example.org, though some networks omit the leading _ like freenode: @freenode_NickServ:matrix.org. You can figure out the network prefix from Bridged IRC networks.

Then you can register/identify normally depending on the syntax of your network which you can generally check by saying "help register" or "help identify".

For example freenode uses the syntaxes:

• identify [<nickname>] <password>
  • where nickname is optional assuming you are identifying for your current nickname
• register <password> <email>

And do it automatically?

Again in direct chat with the @appservice-irc you can use !storepass <string> command to save a string that is sent in PASS command when your ghost (=your IRC-presence) connects if your network sends the PASS command to NickServ.

With freenode you can !storepass nickname:password, some only accept the !storepass password and some just ignore the command.

Why I don't get messages from unregistered-to-IRC IRC users?

The bridges on matrix.org automatically sets umode +R (+G at OFTC) for all ghosts instructing the IRC server to not send messages from unidentified users.

When an IRC user sends a private message to Matrix user, the bridge converts it to a room and invites the Matrix user there. In the past, there have been PM spam bots causing 2000+ room invites in a short time and crashing Synapse (the Matrix homeserver software) on matrix.org taking the whole homeserver down and the best way to prevent this from happening again is requiring registration which should be available for all IRC users.

How do I change the topic?

If you are a moderator at Matrix and op at IRC

Simply set the room topic at Matrix and it will automatically sync to IRC.

If you aren't op at IRC or the channel is -t

Use the raw TOPIC command. Don't forget to prepend the : character before the sentence you will set as topic. For example:

!cmd TOPIC #foo :Welcome to the #foo channel!

will set Welcome to the #foo channel! as the topic for the #foo IRC channel.