Unix
- Copy ~/.xchat2 to ~/.config/hexchat
- Rename ~/.config/hexchat/xchat.conf to ~/.config/hexchat/hexchat.conf
- Rename ~/.config/hexchat/servlist_.conf to ~/.config/hexchat/servlist.conf
- Rename ~/.config/hexchat/xchatlogs to ~/.config/hexchat/logs
- Move all your 3rd party addons (plugins/scripts) to ~/.config/hexchat/addons
Windows
- Copy %APPDATA%\X-Chat 2 to %APPDATA%\HexChat
- Rename %APPDATA%\HexChat\xchat.conf to %APPDATA%\HexChat\hexchat.conf
- Rename %APPDATA%\HexChat\servlist_.conf to %APPDATA%\HexChat\servlist.conf
- Rename %APPDATA%\HexChat\xchatlogs to %APPDATA%\HexChat\logs
- Move all your 3rd party addons (plugins/scripts) to %APPDATA%\HexChat\addons
Note that copying a colors.conf without a pevents.conf may result in theming issues.
In the Network list select the Network you want to auto-connect to and click Edit and turn ON the “Auto connect to this network at startup” checkbox.
List channels in the favorites list to join them on connect.
Try the following command from a chat window:
/set net_ping_timeout 31
There are 3 ways to authenticate before joining a channel, all are network dependant but nickserv is common:
Control Panel ‣ Default Programs
If these do not work or you do not use a DE use the command gvfs-mime:
gvfs-mime –set x-scheme-handler/http firefox.desktop
If you hate gvfs you can manually edit ~/.local/share/applications/mimeapps.list to include:
x-scheme-handler/http=firefox.desktop;
Don’t forget to do the same for https.
Now upon launching it will use the Exec line in their desktop file replacing %u with the url. If you get a blank window this is where the problem is.
Alternatively you can add an Url Handler
Go to the menus, Settings ‣ Preferences ‣ Network Setup and fill in the requested information there. Authentication (using a username and password) is only supported for HTTP and Socks5.
For information on Tor see our tips page
To display @ and + characters next to nicknames as they talk, do the following:
In the menus, open up Settings ‣ Text Events. Find the Channel Message event in the list. The $3 code can be inserted to print the user’s mode-character (e.g. @ or +). For example, you might want to change the default:
%C18%H<%H$4$1%H>%H%O$t$2
To
%C18%H<%H$4$3$1%H>%H%O$t$2
Don’t forget to press Enter, so the changes take effect in the list at the top of the window.
Right click the nickname in the userlist, and choose a ban type from the “Kick/Ban” submenu.
You can also do it manually: > /ban nick bantype where the bantype is a number from 0 to 3.
Or set the default with:
/set irc_ban_type bantype sets the default ban type to use for all bans. The different types are:
- 0 = *!@.host
- 1 = *!*@domain
- 2 = *!user@.host
- 3 = *!*user@domain
Some networks allow very long nicknames (up to 32 letters). It can be annoying to have the separator bar move too far to the right, just for one long nick. Therefore, it has a set limit for the distance it will move to the right. If you use a large font, you may need to adjust this distance. It is set in pixels, for example:
/set text_max_indent 320
Once you adjust this setting high enough, overlapping timestamps and nicknames should not occur. The adjustment will not take effect immediately, a restart may be needed.
Right-click on the tab you want to change. In the submenu of the channel name, there’s a toggle-item “Show join/part messages”, simply turn this off.
If you want to turn this option on globally go to Settings ‣ Preferences ‣ Advanced.
Then all channels you join after setting this will start with “Show join/part messages” turned off.
If you are behind a IP-NAT or ADSL router, you will most likely have an address like 192.168.0.1. This address is not usable on the Internet, and must be translated.
When offering a DCC file, HexChat will tell the receiver your address. If it says 192.168.0.1, the receiver will not be able to connect. One way to make it send your “real” address is to enable the “Get my IP from IRC Server” option in HexChat. This option is available in Settings ‣ Preferences ‣ File Transfers. When you turn it ON, you will have to re-login to the server before it’ll take effect.
You will also need to forward some ports for use in DCC send. You may pick almost any port range you wish, for example, in HexChat set:
- First DCC send port: 4990
- Last DCC send port: 5000
This will allow you to send up to ten files at the same time, which should be plenty for most people. Lastly, configure your router/modem to forward ports 4990-5000 to your PC’s address. You’ll have to consult your router/modem’s manual on how to do this.
There are three ways to do this:
If you get this error when trying to load a Perl or Python script, it means the plugin for running those scripts isn’t loaded.
In the menus, go to: Settings ‣ Preferences ‣ Sound. Select the event you want to make a sound on, then type in a sound filename (or use the Browse button).
The root of your HexChat config is:
Referred to as <config> from now. HexChat automatically loads, at startup:
On both Unix and Windows there is an included tray plugin. To enable minimizing to tray on exit go to Settings ‣ Preferences ‣ Alerts.
To see the various launch options such as setting configdir or minimize level run:
hexchat –help
Unix
~/.config/hexchat/logs
Windows
%APPDATA%\HexChat\logs
By default settings, no rotation occurs, your log files will just keep getting larger.
Go to Settings ‣ Preferences ‣ Logging and change the log filename to any one of these:
%Y-%m-%d/%n-%c.log -> 2006-12-30/FreeNode-#channel.log
%n/%Y-%m-%d/%c.log -> FreeNode/2006-12-30/#channel.log
%n/%c.log -> FreeNode/#channel.log (no rotation)
%Y, %m and %d represents the current year, month and day respectively. %n is the network name, e.g. “FreeNode” or “UnderNet”, and finally, %c is the channel. In these examples, a new log filename and folder would be created after midnight.
The format can also be a full path if you want to save logs to an external drive for example.
For the full list of formatting codes, please refer to the Unix or Windows documentation on strftime.
The Real name field used to be accessible via the Network List, which is the very first screen that a new user sees. Newcomers, who are not familiar with IRC terminology, might be afraid of their personal data. In order to avoid alienating such people, we decided to remove this setting from the Network List. Now you can access this setting under Settings ‣ Preferences ‣ Advanced instead, or if you prefer the command line, you can use the following command:
/set irc_real_name Stewie Griffin
On Windows, HexChat is using the Instant Message Notification system sound for making beep alerts, and if it’s unspecified, it attempts to produce a simple beep effect. In case you don’t hear beeps when alerts occur, you need to set this system sound to the desired sound effect. To do this, go to Control Panel ‣ Hardware and Sound ‣ Change system sounds.
Press Ctrl + Shift + U at once. When you release the keys, u will appear in your input box.
Now you can enter the 4-digit code of the desired glyph. When you’re done, just press Space or Return, and the glyph will appear as well.