SWIRC.CONF(5)

NAME
swirc.conf - swirc configuration file

DESCRIPTION
This manual page describes swirc.conf which is a configuration file for swirc(1) (a curses based irc client). NOTE Certain settings take effect first after program restart while others don't!

SETTING TYPES

bool
    Bools are case insensitive and can have one of the following values:
    •   on, true or yes
    •   off, false or no

int Integers. swirc implements a min/max value for each integer in order to keep its value safe. The error log will tell if the restrictions for an integer aren't within limits and, if so, that a preprogrammed fallback value is being used instead.

string
    A sequence of characters

SETTINGS

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(1) 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. The server time extension is particularly useful if you're using an IRC bouncer like ZNC: https://znc.in/

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:
    •   ECDSA-NIST256P-CHALLENGE
    •   PLAIN
    •   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.

FILES
~/.swirc/swirc.conf
    swirc configuration file

SEE ALSO
swirc(1)