2.3 Configuration

These are some variables you can change to configure rcirc to your liking.

rcirc-server-alist

This variable contains an alist of servers to connect to by default and the keywords parameters to use. The keyword parameters are optional. If you don’t provide any, the defaults as documented below will be used.

The most important parameter is the :channels parameter. It controls which channels you will join by default as soon as you are connected to the server.

Here’s an example of how to set it:

(add-to-list 'rcirc-server-alist
             '("otherworlders.org"
               :channels ("#FUDGE" "#game-design")))

By default you will be connected to the rcirc support channel: #rcirc on irc.libera.chat.

:nick

This overrides rcirc-default-nick.

:port

This overrides rcirc-default-port.

:user-name

This overrides rcirc-default-user-name.

:full-name

This overrides rcirc-default-full-name.

:channels

This describes which channels to join when connecting to the server. If absent, no channels will be connected to automatically.

rcirc-default-nick

This variable is used for the default nick. It defaults to the login name returned by user-login-name.

(setopt rcirc-default-nick "kensanata")
rcirc-default-port

This variable contains the default port to connect to. It is 6667 by default and rarely needs changing.

rcirc-default-user-name

This variable contains the default user name to report to the server. It defaults to the login name returned by user-login-name, just like rcirc-default-nick.

rcirc-default-full-name

This variable is used to set your “real name” on IRC. It defaults to the name returned by user-full-name. If you want to hide your full name, you might want to set it to some pseudonym.

(setopt rcirc-default-full-name "Curious Minds Want To Know")
rcirc-authinfo

This variable is an alist used to automatically identify yourself on networks. Each sublist starts with a regular expression that is compared to the server address you’re connecting to. The second element in the list is a symbol representing the method to use, followed by the arguments this method requires.

Here is an example to illustrate how you would set it:

(setopt rcirc-authinfo
        '(("Libera.Chat" nickserv "bob" "p455w0rd")
          ("Libera.Chat" chanserv "bob" "#bobland" "passwd99")
          ("bitlbee" bitlbee "robert" "sekrit")))

And here are the valid method symbols and the arguments they require:

nickserv

Use this symbol if you need to identify yourself as follows when connecting to a network: /msg nickserv identify secret. The necessary arguments are the nickname you want to use this for, and the password to use.

Before you can use this method, you will have to register your nick and pick a password for it. Contact nickserv and check out the details. (Using /msg nickserv help, for example.)

chanserv

Use this symbol if you need to identify yourself as follows if you want to join a particular channel: /msg chanserv identify #underground secret. The necessary arguments are the nickname and channel you want to use this for, and the password to use.

Before you can use this method, a channel contact must tell you about the password to use. Contact chanserv and check out the details. (Using /msg chanserv help, for example.)

bitlbee

Use this symbol if you need to identify yourself in the Bitlbee channel as follows: identify secret. The necessary arguments are the nickname you want to use this for, and the password to use.

Bitlbee acts like an IRC server, but in fact it is a gateway to a lot of other instant messaging services. You can either install Bitlbee locally or use a public Bitlbee server. There, you need to create an account with a password. This is the nick and password you need to provide for the bitlbee authentication method.

Later, you will tell Bitlbee about your accounts and passwords on all the other instant messaging services, and Bitlbee will log you in. All rcirc needs to know, is the login to your Bitlbee account. Don’t confuse the Bitlbee account with all the other accounts.

sasl

Use this symbol if you want to use SASL authentication. The necessary arguments are the nickname you want to use this for, and the password to use.

certfp

Use this symbol if you want to use CertFP authentication. The necessary arguments are the path to the key and to the client certificate associated with the account. The CertFP authentication requires a TLS connection.