Settings

Config Files

Config files are stored as plaintext files (which shouldn’t be edited by hand). They are located in:

  • Windows: %APPDATA%\ZoiteChat

  • Unix: ~/.config/zoitechat

  • Flatpak: ~/.var/app/io.github.Hexchat/config/zoitechat

  • Snap: ~/snap/zoitechat/current/.config/zoitechat

Note

Type the path into your file browser to expand them into a full directory.

Custom directories can be set with the -d or –cfgdir command line argument.

On Windows there is a portable mode option which makes ZoiteChat store settings inside of a \config subdir within the main installation folder. Though this option should only be used if you must for a portable drive or if you lack administrative priviliges for installation.

Network List

The network list contains a list of networks, basic user information, and per network settings. It can be accessed in ZoiteChat ‣ Network List or by the keyboard shortcut Control-s.

User Information

This is where basic information is set for the user such as nicknames, these will be used as defaults for networks but can be overridden. The Realname field is entirely optional. The username is often used for options like Server and SASL password.

Networks

ZoiteChat comes with a list of default networks but you can easily add your own or edit existing ones. The sorting and names of networks do matter as some commands reference the network by the name here, e.g. /newserver. The order they are sorted in this list also determines the order of auto-connecting. To edit the order just select one and hit Shift-up or Shift-down.

Servers

Per network you can maintain a list of servers in case of one fails. The syntax for these servers hostname/port. The port is entirely optional and can be prefixed by + to signify SSL. If no port is given the default port used is 6667 and 6697 for SSL.

Your Details

Unticking Use global user information allows unique nicknames or usernames between networks.

Connecting

Ticking Auto connect to this network at startup combined with Favorite channels will allow you to quickly connect and join chats.

The password fields allow you to login to a password protected server or services. They take the syntax username:password or just the password if username has been set as mentioned above.

See also

See the FAQ if you have trouble identifying before join.

Channel Options

Some options can be specific to channels. To access these you can right click on any tab or use the command /chanopt. Any option other than 0 or 1 is considered unset and will use the globally set defaults.

Preferences

Keyboard Shortcuts

There are two types of keyboard shortcuts in ZoiteChat hardcoded ones which can be found by looking around in the menu, e.g. Control-s, and configurable ones in Settings ‣ Keyboard Shortcuts. These have help messages to guide you through setting up custom bindings.

Url Handlers

Url handlers add alternative browsers to you your right click menu on urls (they do not set the default). They take the syntax:

!program %s or !"C:\Program Files\Program\program.exe" %s

Note

If ZoiteChat does not find the executable it will not add it to the menu.

Auto Replace

Located in Settings ‣ Auto Replace this setting allows you to replace text while typing. The Text column is what it is to detect and the Replace with column is what will replace it. This column accepts color codes from Text Events

For Example:

text: –> replace: %C8→%O

This will replace that arrow with a green unicode arrow upon pressing enter or space. The keys that check for replace are defined in Settings ‣ Keyboard Shortcuts. A trick to avoid replacing it Shift-Space since that is not defined by default.

CTCP Replies

Custom CTCP replies can be set in Settings ‣ CTCP Replies and accept the same format as User Commands with the addition of %s for the nick replying to.

Note

To hide the default VERSION reply you must /set irc_hide_version on

Set Command

The set command can be used to change options. The usage is:

/set option_name [number|string]

Togglable options take 1 for on and 0 for off but as an alternative you can type:

/set toggle_option on

If no value is given it will show the current value of a setting. You can also use wildcards to find or show multiple values for example

/set gui_*

Some options such as gui_tray require running this after changing:

/gui apply

This can be avoided by using the preferences window instead, which is recommended, also using the gui will warn if a setting requires restart.

List of Settings