Difference between revisions of "WeeChat"

From ArchWiki
Jump to: navigation, search
(Added how to keep a SSH-connection alive under tips and tricks. It's common to run Weechat on a remote shell, and by default SSH-config you'll disconnect when idle. irssi in comparison keeps the connection alive. Weechat does not support this.)
m (Fixed capitalization of irssi and WeeChat.)
Line 4: Line 4:
 
{{Article summary text|WeeChat is a highly extendable and feature rich IRC Client currently under heavy development.}}
 
{{Article summary text|WeeChat is a highly extendable and feature rich IRC Client currently under heavy development.}}
 
{{Article summary heading|Alternative Clients}}
 
{{Article summary heading|Alternative Clients}}
{{Article summary wiki|Irssi}}
+
{{Article summary wiki|irssi}}
 
{{Article summary wiki|XChat}}
 
{{Article summary wiki|XChat}}
 
{{Article summary end}}
 
{{Article summary end}}
Line 25: Line 25:
  
 
=== Configuration Files ===
 
=== Configuration Files ===
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].
  
 
==Connecting to a server==
 
==Connecting to a server==
Line 81: Line 81:
  
 
===SSH connection lost when idle===
 
===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.
+
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.  
+
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.  
  
 
{{hc|# /etc/ssh/sshd_config|2=
 
{{hc|# /etc/ssh/sshd_config|2=

Revision as of 20:49, 25 August 2012

Tango-document-new.pngThis article is a stub.Tango-document-new.png

Notes: please use the first argument of the template to provide more detailed indications. (Discuss in Talk:WeeChat#)
Summary help replacing me
WeeChat is a highly extendable and feature rich IRC Client currently under heavy development.
Alternative Clients
irssi
XChat

Installing

WeeChat is available in the [extra] repo. Install by running:

# pacman -S weechat

There is also weechat-gitAUR in the AUR, install with your favorite AUR Helper or makepkg.

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 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.

Internally

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.<option name>

Configuration Files

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.

/connect chat.freenode.net

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

/connect freenode

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.

Configuring SSL

Many IRC servers, including freenode where #archlinux is, support SSL.

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
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
Note: Different servers may, and probably will have a different port than 7000 - this is server specific.

You can do the same thing if using /connect.

/connect chat.freenode.net/7000 -ssl

Tips and Tricks

Upgrading

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

/upgrade

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

Aliases

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

Smart Filter
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

/sfilter

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

/rmsfilter

Key Bindings

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

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.

# /etc/ssh/sshd_config
ClientAliveInterval 300

Getting Help

To access WeeChat's built-in help, simply type

/help

and the help will be displayed in the main buffer (usually buffer 1).

External Links

WeeChat Home Page
WeeChat Documentation
WeeChat Scripts
WeeChat Development Blog