WeeChat is going to have multiple interfaces at some point, run weechat-[interface] to start WeeChat.
As WeeChat currently only has a Ncurses interface the command to start WeeChat is: Template:Cli
You can configure WeeChat in 2 ways: internally, from the command line or by editing the .conf files located in ./weechat directly. WeeChat will automatically save settings on exit, so if you are editing a .conf file in an editor, be sure to run
/reload from the console before exiting, otherwise your changes will be lost.
You can get a list of all configurable options by typing
/set in the weechat buffer window. Since there are nearly 600 default configurable options, you can search through them with a wildcard syntax:
/set irc.server.* or
/set *server* as an example. You can get help on each option with the
/help irc.server.freenode.<option name>
The .conf files for weechat are saved to
~/.weechat. These files are not commented. Detailed information can be found within the program itself (see Internally above), or WeeChat's user guide.
Connecting to a server
You can connect to a IRC server by using /connect.
Or if there is already a Server setup you can use:
Creating a Server profile
If you plan on connecting to a server more than once it may be beneficial to create a Server.
/server add example irc.example.net/6667
Would create the server example which would connect to irc.example.net on port 6667
See the WeeChat documentation and /help server for more information.
If you're making a server with /server add -ssl to the end of the line, for example:
/server add FreenodeSSL chat.freenode.net/7000 -ssl
You can do the same thing if using /connect.
/connect chat.freenode.net/7000 -ssl
Tips and Tricks
WeeChat can be upgraded without disconnecting from the IRC servers (non-SSL connections only):
This will load the new WeeChat binary and reload the current configuration.
Aliases can be created to simplify commonly executed commands. A nice example is Wraithan's smart filter alias:
First, we need to enable smart filters:
/set irc.look.smart_filter "on"
Next, we will create the sfilter alias:
/alias sfilter filter add irc_smart_$server_$channel irc.$server.$channel irc_smart_filter *
We can now type
in any buffer, and the smart filter will only be enabled for that buffer.
The following alias will remove a previously enabled smart filter in the current buffer:
Add the alias:
/alias rmsfilter filter del irc_smart_$server_$channel
and execute it by
Some helpful bindings:
To use ctrl-left/right arrow keys to jump to next/previous words on the input line:
/key bind meta2-1;5D /input move_previous_word /key bind meta2-1;5C /input move_next_word
To access WeeChat's built-in help, simply type
and the help will be displayed in the main buffer (usually buffer 1).