Using irc.libera on WeeChat

2021-09-16 | aprates.dev

Internet Relay Chat (IRC) is a text-based chat system. It enables discussions among any number of participants in so-called conversation channels, as well as discussions between only two partners. - Wikipedia

Flashback

┏┳┓╻┏━┓┏━╸   ╻┏━╸┏━┓   ┏┳┓┏━┓┏┓╻
┃┃┃┃┣┳┛┃     ┃┃  ┃┓┃   ┃┃┃┗━┓┃┗┫
╹ ╹╹╹┗╸┗━╸   ╹┗━╸┗┻┛   ╹ ╹┗━┛╹ ╹

I remember using IRC in my teenage years… Mixed memories of mirc, icq, msn and long lasting chats, while writing some html on win95 using ms notepad :P

Fast-forward to 2021

As fresh services like libera [2] stepped in, and new channels about 'libre' open-source projects started blooming here and there, I felt like getting around and joining the new wave. Fear of missing out? Nah, more like developer tribe thing. I decided to do that while also trying to live a bit more on the command line…

…but not so fast!

Opting for terminal based WeeChat [3] as IRC client, I found out it needs quite some arcane configuration steps, which after a few back and forth, and some mistakes, I decided to rm -r ~/.config/weechat and start over. While doing it carefully for the second time. I've took note of the right steps this time and wrote them in this tutorial, hoping that it might be useful to someone (even if it's the future me when I forget how to do it again).

So, How To Do It?

For Linux WeeChat should be available via your favorite package manager on pretty much all main distros. For macOS you can install it via Homebrew [4] and… Windows? Maybe over WSL - not sure, haven't tried.

### Step-By-Step Setup

Do this in the order, as I describe, that is the trick: the right order.

* First of all, from the command line, start the app:

weechat

* Add `libera` server (with SSL):

/server add libera irc.libera.chat/6697 -ssl

* Set your username (better before you connect):

/set irc.server.libera.nicks

/set irc.server.libera.username

Connect and enable auto-connect:

/connect libera
/set irc.server.libera.autoconnect on

/msg NickServ REGISTER

For the password, enter a new password for your user. Then you will get an e-mail with a command you need to enter to confirm your registration. It will look like this:

/msg NickServ VERIFY REGISTER

Finally, configure SASL (same password you used on registration):

/set irc.server.libera.sasl_mechanism PLAIN
/set irc.server.libera.sasl_username 
/set irc.server.libera.sasl_password

Ensure all your configs are saved with:

/save

et voilà!

Usage Tips

If it's the case you haven't used IRC before, or like me, forgot most of it. Don't feel lost, here goes a quick recap…

Join a channel:

/join #channel

Send a private message to someone (only you both will see this message):

/msg user message

Start a private chat with someone (like a separate channel):

/query user message

Start a private chat with two or more users (use comas, but no spaces):

/query user1,user2,user3 message

Ask a users if they want to join you on a channel:

/invite user #channel

Close a thread:

/close

Extra Tips

Scroll the chats with your mouse wheel:

/set weechat.look.mouse on

Auto-join your favorite channels when WeeChat starts:

/set irc.server.libera.autojoin "#channel1,#channel2"

Filter IRC join/quit messages (unless you find them useful):

/set irc.look.smart_filter on
/filter add irc_smart * irc_smart_filter *

That's it, a bit of a faff, but at last, all set!

Now you can enjoy chatting directly from a terminal :D

References

=> libera | WeeChat | Homebrew | Nick Registration