Settings¶
Config Files¶
Config files are stored as plaintext files (which shouldn’t be edited by hand). They are located in:
Windows:
%APPDATA%\ZoiteChatUnix:
~/.config/zoitechatFlatpak:
~/.var/app/io.github.Hexchat/config/zoitechatSnap:
~/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 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 Connect to this network automatically combined with favorite or autojoin channels lets ZoiteChat connect and join chats automatically.
The Login method setting controls how ZoiteChat identifies to the server or services. The password field is used by password-based login methods, including server password, NickServ, SASL, and custom connect commands. For custom connect commands, %p expands to the saved password.
Passwords are hidden by default. When a password already exists, the field may show ***; this is only a placeholder, not the real password. Tick Show password to load and reveal the current password from the correct storage backend.
Tick Use system keyring to store the selected network’s password in the operating system keyring instead of the local network configuration file. On Windows this uses Windows Credential Manager. On Unix-like systems this requires libsecret support and a working desktop keyring. If the keyring is locked, ZoiteChat may ask the system to unlock it before the password can be edited.
When Use system keyring is disabled, ZoiteChat stores the saved password locally. New local passwords are saved in encrypted local storage when encryption support is available. Local encrypted passwords are less protected than the system keyring and are tied to the current user and configuration directory.
Two migration buttons may appear for existing locally saved passwords:
Encrypt saved password converts an existing local plaintext password to encrypted local storage.
Move password to keyring moves an existing local password into the system keyring and removes the local saved password from the network configuration.
Close the edit window to save changes to the password, login method, and selected password storage mode.
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 . 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 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 . A trick to avoid replacing it Shift-Space since that is not defined by default.
CTCP Replies¶
Custom CTCP replies can be set in 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.