WeeChat is going to have multiple interfaces at some point, run '''weechat-[interface]''' to start WeeChat.

WeeChat is going to have multiple interfaces at some point, run '''weechat-[interface]''' to start WeeChat.

Line 19:

Line 20:

== Configuration ==

== Configuration ==

−

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 {{ic|/reload}} from the console before exiting, otherwise your changes will be lost.

+

−

=== Internally ===

+

You can configure WeeChat in 3 ways: using WeeChat's internal commands; using '''iset'''; or by editing the .conf files directly. WeeChat will automatically save settings on exit, so if you are editing a .conf file in an editor, be sure to run {{ic|/reload}} from the console before exiting, otherwise your changes will be lost.

+

+

=== Internal commands ===

+

You can get a list of all configurable options by typing {{ic|/set}} in the '''weechat''' buffer window. Since there are nearly 600 default configurable options, you can search through them with a wildcard syntax: {{ic|/set irc.server.*}} or {{ic|/set *server*}} as an example. You can get help on each option with the {{ic|/help}} command:

You can get a list of all configurable options by typing {{ic|/set}} in the '''weechat''' buffer window. Since there are nearly 600 default configurable options, you can search through them with a wildcard syntax: {{ic|/set irc.server.*}} or {{ic|/set *server*}} as an example. You can get help on each option with the {{ic|/help}} command:

−

/help irc.server.freenode.<option name>

+

+

/help irc.server.freenode.autoconnect

+

+

=== Internal menu-based ===

+

+

For a more convenient method, install the '''iset''' script. If you have weechat 0.3.9, run:

The .conf files for WeeChat are saved to {{ic|~/.weechat}}. These files are not commented. Detailed information can be found within the program itself (see '''Internally''' above), or WeeChat's [http://www.weechat.org/files/doc/stable/weechat_user.en.html user guide].

The .conf files for WeeChat are saved to {{ic|~/.weechat}}. These files are not commented. Detailed information can be found within the program itself (see '''Internally''' above), or WeeChat's [http://www.weechat.org/files/doc/stable/weechat_user.en.html user guide].

Line 32:

Line 52:

Or if there is already a '''Server''' setup you can use:

Or if there is already a '''Server''' setup you can use:

/connect freenode

/connect freenode

+

==Creating a Server profile==

==Creating a Server profile==

If you plan on connecting to a server more than once it may be beneficial to create a '''Server'''.

If you plan on connecting to a server more than once it may be beneficial to create a '''Server'''.

Line 44:

Line 65:

If you're making a server with '''/server''', add the SSL port (usually 6697) and '''-ssl''' to the end of the line. For example:

If you're making a server with '''/server''', add the SSL port (usually 6697) and '''-ssl''' to the end of the line. For example:

−

/server add FreenodeSSL chat.freenode.net/6697 -ssl

+

/server add freenode chat.freenode.net/6697 -ssl

You can do the same thing if using '''/connect'''.

You can do the same thing if using '''/connect'''.

Line 50:

Line 71:

/connect chat.freenode.net/6697 -ssl

/connect chat.freenode.net/6697 -ssl

−

{{Warning|Some servers need the '''ssl_dhkey_size''' value changed to something lower. For example, if you're using freenode you'll need to set '''/set irc.server.FreenodeSSL.ssl_dhkey_size 1024'''}}

+

{{Warning|Some servers need the '''ssl_dhkey_size''' value changed to something lower. For example, if you're using freenode you'll need to set '''/set irc.server.freenode.ssl_dhkey_size 1024'''}}

{{Box BLUE|Note:| Different servers may have a different port than 6697 - this is server specific.}}

{{Box BLUE|Note:| Different servers may have a different port than 6697 - this is server specific.}}

==Tips and Tricks==

==Tips and Tricks==

+

===Upgrading===

===Upgrading===

WeeChat can be upgraded without disconnecting from the IRC servers (non-SSL connections only):

WeeChat can be upgraded without disconnecting from the IRC servers (non-SSL connections only):

/upgrade

/upgrade

This will load the new WeeChat binary and reload the current configuration.

This will load the new WeeChat binary and reload the current configuration.

+

===Aliases===

===Aliases===

Aliases can be created to simplify commonly executed commands. A nice example is Wraithan's '''smart filter''' alias:

Aliases can be created to simplify commonly executed commands. A nice example is Wraithan's '''smart filter''' alias:

Installing

Running WeeChat

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:

$ weechat-curses

Configuration

You can configure WeeChat in 3 ways: using WeeChat's internal commands; using iset; or by editing the .conf files 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.

Internal commands

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 command:

/help irc.server.freenode.autoconnect

Internal menu-based

For a more convenient method, install the iset script. If you have weechat 0.3.9, run:

Key Bindings

SSH connection lost when idle

If you're connecting to your WeeChat through a remote shell using SSH, for example running it in screen or tmux you might experience getting disconnecting after a while when idle. There are multiple factors in play why this might happen, but the easiest way to change this is to force the connection to be kept alive by appending this to your SSH-configuration on the remote shell.
This has nothing to do with WeeChat itself, but losing connection when idle won't happen with it's alternative irssi by default, and thus is a common situation for those converting to WeeChat.