Difference between revisions of "WeeChat"

From ArchWiki
Jump to: navigation, search
m (Configuration)
Line 19: Line 19:
  
 
== 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 automatically on exit, so if you are editing a .conf file in an editor, be sure to run <code>/reload</code> before exiting, otherwise your changes will be lost.
+
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 <code>/reload</code> from the console before exiting, otherwise your changes will be lost.
 
=== Internally ===
 
=== Internally ===
 
You can get a list of all configurable options by typing <code>/set</code> in the '''weechat''' buffer window. Since there are nearly 600 default configurable options, you can search through them with a wildcard syntax: <code>/set irc.server.*</code> or <code>/set *server*</code> as an example. You can get help on each option with the <code>/help</code> command:  
 
You can get a list of all configurable options by typing <code>/set</code> in the '''weechat''' buffer window. Since there are nearly 600 default configurable options, you can search through them with a wildcard syntax: <code>/set irc.server.*</code> or <code>/set *server*</code> as an example. You can get help on each option with the <code>/help</code> command:  

Revision as of 06:38, 21 July 2011

This template has only maintenance purposes. For linking to local translations please use interlanguage links, see Help:i18n#Interlanguage links.


Local languages: Català – Dansk – English – Español – Esperanto – Hrvatski – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Norsk Bokmål – Polski – Português – Slovenský – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – العربية – ไทย – 日本語 – 正體中文 – 简体中文 – 한국어


External languages (all articles in these languages should be moved to the external wiki): Deutsch – Français – Română – Suomi – Svenska – Tiếng Việt – Türkçe – فارسی

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

Template:Package Official is available in the [extra] repo. Install by running: Template:Cli There is also Template:Package AUR 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: Template:Cli

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

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