swirc logo Swirc
“The universal IRC client”


Updated: 2019-11-23

Configuration options in swirc.conf

NOTE Certain settings take effect first after program restart while others don't!

account_notify (bool)
Allows a client to be notified when another client’s accountname changes
alt_nick (string)
Alternative nickname. This nickname is used when processing a connection to a server and the default nickname is busy.
auto_op_yourself (bool)
Automatically op yourself on channel join when you're identified as an IRC operator
away_notify (bool)
Allows a client to specify that it would like to be notified when users are marked/unmarked as away
beeps (bool)
swirc alerts the user by sending a beep in certain cases. However, with the help of this setting, beeps can be turned on/off.
chanserv_host (string)
ChanServ hostname
cipher_suite (string)
Cipher suite. Which can have one of the following values:
  • secure
  • compat
  • legacy
  • insecure (which should've been named all because it will never be used because of its name)
cmd_hist_size (int)
Command history size. No more than this number of commands will be stored in the memory.
connection_timeout (int)
Connection timeout in seconds
hostname_checking (bool)
Enable or disable TLS/SSL hostname verification
invite_notify (bool)
Allows a client to specify that it would like to be notified when users are invited to channels
ircv3_server_time (bool)
Enable or disable IRCv3 server time extension
joins_parts_quits (bool)
Show JOIN/PART/QUIT events?
kick_close_window (bool)
If the active user gets kicked out from a channel, should the channel window be terminated?
max_chat_windows (int)
Max chat windows that can be open simultaneously
nickname (string)
Online nickname
nickname_aliases (string)
A space separated list of nickname aliases which are used, in addition to the default nickname, to highlight a message if it matches any of the aliases given by this setting.
nickserv_host (string)
NickServ hostname
part_message (string)
Message when leaving a channel
quit_message (string)
Message when disconnecting from a server
real_name (string)
Specifies the real name.
But can be set to anything.
reconnect_backoff_delay (int)
The number of seconds that should be added to each reconnect attempt (0-99)
reconnect_delay (int)
Seconds to consume before the first reconnect attempt (0-999)
reconnect_delay_max (int)
Maximum reconnect delay in seconds (0-999). Regardless of the other related reconnect settings.
reconnect_retries (int)
If the IRC connection is lost, how many attempts should be performed to get the connection working again before giving up?
sasl (bool)
Request SASL authentication on connection to a server?
sasl_mechanism (string)
SASL mechanism. Available mechanisms are:
  • SCRAM-SHA-256
Be sure to write them in all uppercase!
sasl_password (string)
SASL password. For mechanism PLAIN and SCRAM-SHA-256.
sasl_username (string)
SASL username
show_ping_pong (bool)
Show ping pong events?
The default is NO.
skip_motd (bool)
Skip message of the day (MOTD) on connection to a server?
ssl_verify_peer (bool)
Verify peer? Setting it to NO decreases TLS/SSL security significantly, but is a must on servers with trusted self signed certificates.
startup_greeting (bool)
Enable or disable Swirc startup greeting
textbuffer_size_absolute (int)
Max number of elements in a text buffer before head gets removed from scroll back history. Each open window is assigned a buffer with this size, so set a sane value!
theme (string)
swirc theme.
username (string)
User identity. Preferably to be set to the same as the nickname.


Copyright © 2012-2021 Markus Uhlin. ALL RIGHTS RESERVED.