Difference between revisions of "WeeChat"

From ArchWiki
Jump to: navigation, search
m (changed layout)
Line 11: Line 11:
 
  # pacman -S weechat
 
  # pacman -S weechat
 
There is also {{Package AUR|weechat-git}} in the AUR, install with your favorite [[AUR Helper|AUR Helper]] or [[makepkg]].
 
There is also {{Package AUR|weechat-git}} in the AUR, install with your favorite [[AUR Helper|AUR Helper]] or [[makepkg]].
 +
 +
 
==Running WeeChat==
 
==Running WeeChat==
 
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.  
 
  
 
As WeeChat currently only has a Ncurses interface the command to start WeeChat is:
 
As WeeChat currently only has a Ncurses interface the command to start WeeChat is:
 
  # weechat-curses
 
  # weechat-curses
 +
 +
 
==Configuring SSL==
 
==Configuring SSL==
 
Many IRC servers, including [http://freenode.net/ freenode] where [[IRC_Channel|#archlinux]] is, support SSL.
 
Many IRC servers, including [http://freenode.net/ freenode] where [[IRC_Channel|#archlinux]] is, support SSL.
 
  
 
If you're making a server with '''/server''' add '''-ssl''' to the end of the line, for example:
 
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
 
  /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'''}}
+
{{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'''}}
{{Box BLUE|Note:| different servers may, and probably will have a different port than 7000, this is server specific.}}
+
{{Box BLUE|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'''.
 
You can do the same thing if using '''/connect'''.
 
  /connect chat.freenode.net/7000 -ssl
 
  /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:<br>
 +
Add the alias:
 +
/alias rmsfilter filter del irc_smart_$server_$channel
 +
and execute it by
 +
/rmsfilter
 +
 +
 +
==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==
 
==External Links==
 
[http://www.weechat.org WeeChat Home Page]
 
[http://www.weechat.org WeeChat Home Page]
 
+
[http://www.weechat.org/doc/ WeeChat Documentation]
 
[http://www.weechat.org/scripts/ WeeChat Scripts]
 
[http://www.weechat.org/scripts/ WeeChat Scripts]

Revision as of 00:46, 30 January 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#)
Template:Article summary start

Template:Article summary text Template:Article summary heading Template:Article summary wiki Template:Article summary wiki Template:Article summary end

Installing

Template:Package Official is available in the [extra] repo. Install by running:

# pacman -S weechat

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:

# weechat-curses


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


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