SETTING UP IRSSI

IRC SERVERS

Pick your servers wisely (with a trusted SSL certificate)!

INSTALL

Slackware

slackpkg install irssi utf8proc screen utempter

Ubuntu

apt install irssi screen

SETUP

Eventually launch/quit Irssi just to backup the default config as follows

screen -S chat

irssi
/quit
cp -pi ~/.irssi/config ~/.irssi/config.dist

Choose a theme e.g.

cd ~/.irssi/
wget http://irssi-import.github.io/themes/agon.theme

Now launch Irssi for real, and setup a few things e.g.

irssi

#/set nick NICKNAME
/set real_name REALNAME
/set alternate_nick ALTERNATE_NICKNAME
/set theme agon
/hilight NICKNAME
/hilight YOUR-DOMAIN
/set hilight_nick_matches_everywhere on
/set beep_msg_level
/set beep_msg_level MSGS HILIGHT DCCMSGS NOTICES DCC CTCP

/set autolog on
/set autolog_colors on
/set completion_char ,
/set completion_nicks_lowercase on
/set ctcp_version_reply none of your business

Add missing networks incl. SASL authentication

/network add Online
/network add -sasl_username <login> -sasl_password <password> -sasl_mechanism PLAIN +R Libera

also tweak existing ones to authenticate through SASL

/network modify -sasl_username NICKNAME -sasl_password PASSWORD-HERE -sasl_mechanism PLAIN -usermode +R Freenode

Define servers for those e.g.

/server list

/server add -tls -tls_verify -network IRCnet -auto ssl.ircnet.ovh 6697

/server remove chat.freenode.net
/server add -tls -tls_verify -network Freenode -auto barjavel.freenode.net 6697

# no sasl
/server add -tls -tls_verify -network Online -auto autrechose.evolu.net 6697 PASSWORD-HERE

/server modify -auto irc.oftc.net

# self-signed
/server add -tls -notls_verify -network EFnet -auto irc.efnet.nl 9999
/ircnet add -nick OTHER-NICK EFNet
/ircnet add -alternate_nick ALTERNATE-OTHER-NICK EFNet

/server add -auto -net Libera -ssl -ssl_verify irc.libera.chat 6697

no need to auto-register (and wait before auto-joining channels) that way anymore, it’s better to use SASL or /server directly

#/network add -autosendcmd "/msg nickserv identify PASSWORD-HERE; wait 2000" Online

Autojoin some channels

/channel add -auto #CHANNEL NETWORK

this is the default already, but it’s worth mentioning it

/set rejoin_channels_on_reconnect
#/set rejoin_channels_on_reconnect on

write the configuration

/save

CUSTOM TRUST STORE

server = (
{
    ...
    use_tls = "yes";
    tls_verify = "yes";
    #ssl_capath = "/etc/ssl/certs";
    ssl_cafile = "/etc/ssl/cacert.pem";
    autoconnect = "yes";
},

USAGE

Prevent non-identified users to send you messages

/mode YOUR-NICK +R
/network modify Freenode -usermode +R
/network modify Libera -usermode +R

Check what servers you are currently connected to

/server

Clean-up failing connections

/rmreconns

Cycle through windows

Ctrl-P
Ctrl-N

Go to a preceise window e.g. window 14

/14

Join a channel and multiplex traffic in one window

/join -window #netbsd

TROUBLESHOOTING

11:57:47 *** Irssi: warning SSL handshake failed: wrong version number

==> make sure you’re talking to the server to its SSL port and with its correct FQDN

TODO

/set bell_beeps on does not exist anymore? how to setup bells through gnu/screen and through ssh?

https://thelinuxexperiment.com/notifications-with-irssi-in-screen/\

https://tech.pookey.co.uk/irssi-making-it-beep-when-your-nick-is-mentioned/

https://superuser.com/questions/393059/how-to-make-irssi-running-under-screen-in-a-remote-system-to-beep-on-my-local-pc

https://askubuntu.com/questions/470944/irssi-no-terminal-notification-sound-while-pinged

ALTERNATIVES

ircII project http://www.eterna.com.au/ircii/

EPIC IRC client http://www.epicsol.org/

Irc it (ii) https://tools.suckless.org/ii/

iim - ii improved https://github.com/c00kiemon5ter/iim

RESOURCES

A Guide to Efficiently Using Irssi and Screen https://quadpoint.org/articles/irssi/

Startup How-To https://irssi.org/documentation/startup/

Settings Documentation https://irssi.org/documentation/settings/

Tips and Tricks https://irssi.org/documentation/tips/

Help: log https://irssi.org/documentation/help/log/

\3. Server and channel automation https://irssi.org/documentation/startup/#server-and-channel-automation

Help: server https://irssi.org/documentation/help/server/

Frequently Asked Questions https://irssi.org/documentation/faq/

Startup HOWTO https://tools.ietf.org/doc/irssi/startup-HOWTO.html

Irssi’s /channel, /network, /server and /connect - What It Means https://pthree.org/2010/02/02/irssis-channel-network-server-and-connect-what-it-means/

hilight https://irssi.org/documentation/help/hilight/

FAQ https://irssi.wordpress.com/faq/

ssl

Securing IRC with SSL/TLS. https://lug.oregonstate.edu/blog/irc_and_ssl/

tor

Irssi TOR and SSL configuration https://bbs.archlinux.org/viewtopic.php?id=209806

sasl

Configuring SASL for Irssi https://freenode.net/kb/answer/irssi

Connecting with SASL https://freenode.net/kb/answer/sasl

Configuring SASL for Irssi https://libera.chat/guides/irssi

modes

User Modes https://freenode.net/kb/answer/usermodes

Channel Modes https://freenode.net/kb/answer/channelmodes

altnick per network

Per-server alternate nicks? https://irssi-users.dragoncat.narkive.com/qsjj6lDS/per-server-alternate-nicks

how do i configure a different “nick” per server? https://irssi-users.dragoncat.narkive.com/CiWtHpX3/how-do-i-configure-a-different-nick-per-server


GUIDES | LECTURES | BENCHMARKS | SMTP HEALTH