It is now possible to set max hotlist level for some nicks, per buffer, or per group of buffers (like IRC servers).

A new buffer property "hotlist_max_level_nicks" has been added. It can be set easily with script buffer_autoset.py, see /help autosetbuffer for example.

Possible levels are (default is -1):

• -1: no hotlist changes for nick
• 0: low priority (like join/part messages)
• 1: message
• 2: private
• 3: highlight (in fact useless, since it's default max for all messages)

If you have already opened buffer, then script option will not apply immediately to buffers. Then you can use /buffer command to manually set this property on a buffer, for example, to disable highlights from "joe" and "mike" on current buffer:

/buffer set hotlist_max_level_nicks_add joe:2,mike:2

It is now possible to disable highlights from some nicks, per buffer, or per group of buffers (like IRC servers).

A new buffer property "no_highlightnicks" has been added. It can be set easily with script buffer_autoset.py, see /help autosetbuffer for example.

If you have already opened buffer, then script option will not apply immediately to buffers. Then you can use /buffer command to manually set this property on a buffer, for example, to disable highlights from "joe" and "mike" on current buffer:

/buffer set nohighlightnicks_add joe,mike

Updated on 2010-12-02: this option has been replaced by "hotlist_maxlevel_nicks", see Max hotlist level for some nicks.

Version 0.3.3 is available!

As usual, many new features and bug fixes, see ChangeLog for detail.

Important: please read the release notes if you are upgrading to this version (from any other version).

New major features in this release:

• keys to undo/redo changes on command line
• better lag indicator
• new irc command /wallchops
• display message in irc private buffer when nick is back on server after a /quit
• reverse regex in a filter (with leading "!")
• new option to confirm /quit
• new option to align end of lines
• hashtables in plugin API

New options:

• weechat.look.align_end_of_lines
• weechat.look.confirm_quit
• weechat.look.input_undo_max
• weechat.color.status_name_ssl
• irc.look.display_host_join
• irc.look.display_host_join_local
• irc.look.display_host_quit
• irc.look.display_pv_back
• irc.look.nick_color_stop_chars
• irc.network.autoreconnect_delay_growing
• irc.network.autoreconnect_delay_max
• irc.color.item_lag_counting
• irc.color.item_lag_finished
• irc.color.reason_quit

New keys:

• ctrl + "_": undo (command line)
• alt + "_" (or ctrl + ":" under putty): redo (command line)

Note: to add missing keys, you can use command /key missing

A new script cron.py is now available. It can schedule jobs or message like system commands cron and at.

Two commands are provided by this script:

• /cron: schedule job like system command 'cron'
• /at: schedule job for only one execution, in near future, like system command 'at'.

You can get more help with /help cron and /help at.

You can setup some options with /set:

• /set plugins.var.python.cron.auto_reload on/off (default: on)
• /set plugins.var.python.cron.auto_save on/off (default: on)
• /set plugins.var.python.cron.filename "path" (default: "%h/cron.txt")
• /set plugins.var.python.cron.quiet_exec on/off (default: off)
• /set plugins.var.python.cron.quiet_load on/off (default: off)
• /set plugins.var.python.cron.quiet_save on/off (default: on)

It is now possible to have custom completion for aliases, for example to complete with another command completion, or with your own completion.

Examples:

• create alias /forcejoin with completion of /sajoin: /alias -completion %%sajoin forcejoin /quote forcejoin
• create alias /mybuf with custom completion: /alias -completion #weechat|#weechat-fr mybuf /buffer

You can change completion if alias is already created:

/set alias.completion.forcejoin "%%sajoin"

You can use empty string to prevent any completion for command (default is to complete using target command):

/set alias.completion.forcejoin ""

And you can remove a completion:

/unset alias.completion.forcejoin

Completion is automatically removed when you remove an alias with /unalias.

It is now possible to use date formaters in log filenames (in mask options).

For example to have log by year and month in separate directories, you can do :

/set logger.file.mask "%Y/%m/$plugin.$name.weechatlog"

You'll have a tree like that:

~/.weechat/
    |- logs/
        |- 2009/
            |- 12/
                |  irc.server.freenode.weechatlog
                |  irc.freenode.#weechat.weechatlog
        |- 2010/
            |- 01/
                |  irc.server.freenode.weechatlog
                |  irc.freenode.#weechat.weechatlog

Version 0.3.1 is available!

As usual, many new features and bug fixes, see ChangeLog for detail.

Important: please read the release notes if you are upgrading to this version (from any other version).

New commands have been added to IRC plugin: /allchan and /allserv.
These commands can execute a command on all buffer of all channels or all servers, with optional exclusion of some channels/servers.

Old commands /amsg and /ame are now replaced by aliases. If you're upgrading from recent version (>= 0.3.0), you have to manually create alias, see page with release notes.

New options have been added to check SSL certificates when connecting to IRC servers, thanks to kolter's patch:

• weechat.network.gnutls_ca_file: path to file with certificate authorities (by default: "%h/ssl/CAs.pem")
• irc.server.xxx.ssl_cert: ssl certificate file used to automatically identify your nick (CertFP on oftc for example, see below)
• irc.server.xxx.ssl_dhkey_size: replaces old option weechat.network.gnutls_dh_prime_bitsmax_lines, new default value is 2048 (safer than old default value which was 512)
• irc.server.xxx.ssl_verify: check that the ssl connection is fully trusted (on by default)

Please note that ssl_verify is on by default, so verification is now stricter, and may fail even if it was ok with previous versions of WeeChat.

First example: connect to oftc and check certificate:

• import certificate:
  • mkdir ~/.weechat/ssl
  • wget -O ~/.weechat/ssl/CAs.pem http://www.spi-inc.org/ca/spi-cacert.crt
• in weechat:
  • /connect oftc

Note: it is possible to concatenate many CAs in file CAs.pem.

Second example: connect to oftc using CertFP (certificate to auto identify your nick):

• create certificate:
  • openssl req -nodes -newkey rsa:2048 -keyout nick.key -x509 -days 365 -out nick.cer
  • cat nick.cer nick.key > ~/.weechat/ssl/nick.pem
• in weechat:
  • /set irc.server.oftc.ssl_cert "%h/ssl/nick.pem"
  • /connect oftc
  • /msg nickserv cert add

For more information, please look at https://www.oftc.net/NickServ/CertFP.

A new script hlpvitem.py is now available. It displays item in a bar (like status) with highlight or private message, from an hidden buffer. So you will see content of message before switching to that buffer.

You must add item in a bar, like status, with this command:

/set weechat.bar.status.items

then press "Tab" and complete string by adding for example (without quotes): ",[hlpv]"

Screenshot:

You can setup some options with /set:

• /set plugins.var.python.hlpvitem.showallbuffers on/off (default: off)
• /set plugins.var.python.hlpvitem.buffer_number on/off (default: on)
• /set plugins.var.python.hlpvitem.buffershortname on/off (default: on)
• /set plugins.var.python.hlpvitem.highlight on/off (default: on)
• /set plugins.var.python.hlpvitem.private on/off (default: on)
• /set plugins.var.python.hlpvitem.string_highlight "string" (default: empty)
• /set plugins.var.python.hlpvitem.string_private "string" (default: empty)
• /set plugins.var.python.hlpvitem.string_delimiter "string" (default: " > ")
• /set plugins.var.python.hlpvitem.colorstringhighlight color (default: empty)
• /set plugins.var.python.hlpvitem.colorstringprivate color (default: empty)
• /set plugins.var.python.hlpvitem.colorbuffernumber color (default: empty)
• /set plugins.var.python.hlpvitem.colorbuffername color (default: "default")
• /set plugins.var.python.hlpvitem.color_prefix color (default: "white")
• /set plugins.var.python.hlpvitem.color_delimiter color (default: "cyan")
• /set plugins.var.python.hlpvitem.color_message color (default: "default")
• /set plugins.var.python.hlpvitem.visible_seconds N (default: 7)

Version 0.3.0 is released, after 2 years of work and more than 1000 commits!

This is a major upgrade since last stable, please read files UPGRADE_0.3 and ChangeLog for list of changes: configuration files and plugin API are not compatible with previous versions.

For this important release, site has moved to weechat.org, with a new look!

Enjoy WeeChat!

Major changes were done in script API: data string was added to all callbacks. C plugin API is already ok (there is data pointer for callbacks).
Therefore, all scripts for development version are incompatible with this new version. All official scripts have been updated on plugins page.

This data string must be added after each callback function in arguments of functions. For example in python :

weechat.hook_command("go", "Quick jump to buffers", "", "", "", "go_cmd")
(...)
def go_cmd(buffer, args):

becomes:

weechat.hook_command("go", "Quick jump to buffers", "", "", "", "go_cmd", "")
(...)
def go_cmd(data, buffer, args):

Completion has been improved for command arguments. Now many templates are allowed for one command, and WeeChat will automatically choose and use the better template according to arguments you give on command line.

Let's take an example: the /proxy command. Completion template is this string:

add %(proxies_names) http|socks4|socks5 || del %(proxies_names) || set %(proxies_names) %(proxies_options) || list

The single pipe is still used to add many possible items for one argument. Now a double pipe has been added to separate many templates. WeeChat will choose template according to arguments you give before completion location in command line.
Example 1: if you enter: "/proxy add [+tab]", then WeeChat will use first template ("add %(proxies_names) http|socks4|socks5").
Example 2: if you enter: "/proxy set [+tab]", WeeChat will used third template ("set %(proxies_names) %(proxies_options)").

Now, you'll ask: but how to complete first argument of command? WeeChat can't know which template to use!
Hey, good question! I was sure you would ask that ;)
The answer is very simple: for first argument, WeeChat will make a "or" between first argument of each template (so it will use a fictive template which is: "add|del|set").

It's recommended to use plain words for first argument of each template (when using many templates). If you use many words (separated by single pipe), or items (%(xxx)), then WeeChat will not know which template to use, and may not complete at all.

Another thing you should know, default completion items (defined by WeeChat core) have been renamed. Old name was something like "%x", new name is"%(xxx)". For example %n has been renamed to %(nicks). Some new completions have been added too. Please read doc for new names (and now that includes names of completion items defined by plugins).

If you are using old development version, nick completion will be broken, so you'll have to issue following command: /unset weechat.completion.default_template

Happy completion party!

A new script vdm.py is now available. With that script, you can read fmylife.com and viedemerde.fr websites in WeeChat, using command /vdm.
Help is available with /help vdm when script is loaded.

You can setup some options with /set:

• /set plugins.var.python.vdm.auto_switch on/off (default: on)
• /set plugins.var.python.vdm.blank_line on/off (default: on)
• /set plugins.var.python.vdm.color_number color (default: cyan)
• /set plugins.var.python.vdm.colors color1;color2;... (default: default;green;brown)
• /set plugins.var.python.vdm.lang fr/en (default: en)
• /set plugins.var.python.vdm.numberasprefix on/off (default: on)
• /set plugins.var.python.vdm.reverse on/off (default: off)
• /set plugins.var.python.vdm.url url (default: http://api.betacie.com/view/%s?key=readonly&language=%s)

Screenshot:

A new script go.py is now available. With that script, you can quickly jump to other buffers, by typing some letters. You can use Tab and shift-Tab keys to select next/previous buffer in list.
Help is available with /help go when script is loaded.

Screenshot:

Two new bar filling options have been added: columns_horizontal and columns_vertical. It is used to display bar items in columns, with vertical or horizontal sort.

Screenshot, with 2 nicklists, one on top, one on the right, with columns_vertical filling:

Support for many proxies has been added. It's now possible to create many proxies, and assign different proxy (or no proxy) for each IRC server.

To create, delete, list proxies, use new /proxy command. New IRC option for each server is irc.server.xxx.proxy = name, where name is the name of proxy to use for connection.

For example, to define a http proxy and use it only on freenode server:

/proxy add myproxy http sample.host.org 8888
/set irc.server.freenode.proxy "myproxy"

Logger plugin has been improved with many new features:

• command /logger (to see log status for open buffers, and set/disable log level on a buffer)
• custom level by buffer (or group of buffers)
• custom log filename mask by buffer (or group of buffers).

Set one directory by IRC server and a file by channel inside:

Do that: /set logger.mask.irc irc/$server/$channel.weechatlog

You'll have a tree like that:

~/.weechat/
    |- logs/
        |- irc/
            |--- freenode/
            |       freenode.weechatlog
            |       #weechat.weechatlog
            |       #mychan.weechatlog
            |--- oftc/
            |       oftc.weechatlog
            |       #chan1.weechatlog
            |       #chan2.weechatlog

Log all messages on IRC buffers but not join/part/quit messages:

• for all IRC buffers: /set logger.level.irc 3
• for a server and its channels: /set logger.level.irc.freenode 3
• for a specific channel: /set logger.level.irc.freenode.#weechat 3

A new smart filter for IRC join/part/quit message has been added. It is disabled by default (so you'll see all join/part/quit by default).

To enable it, use following commands:

/set irc.look.smart_filter on
/filter add irc_smart * irc_smart_filter *

You can setup delay: /set irc.look.smart_filter_delay 5

How does it work?

When a nick spoke on channel during past X minutes (where X is delay irc.look.smart_filter_delay), its join/part/quit will be displayed by default. Otherwise, if nick did not speak for a long time, all join/part/quit messages will be tagged with "irc_smart_filter". So you have to define a filter on this tag to hide join/part/quit from users that are not speaking on channel (see command above).

A new plugin Tcl has been added (thanks to Dmitry Kobylin). Some minor changes will be done about compiling (with autotools and cmake), but plugin should be ok today as-is.

Script samples using new API, including Tcl language, will be published soon.

The new /ignore command is now available. You can ignore nicks (or hostnames), using regex.

Note: this command will be improved in near future with more options.

Some exemples (you can find them with /help ignore):

• ignore nick "toto" everywhere: /ignore add toto
• ignore host "toto@domain.com" on freenode server: /ignore add toto@domain.com freenode
• ignore host "toto*@*.domain.com" on freenode/#weechat: /ignore add toto*@*.domain.com freenode #weechat

New version of /upgrade command is now available. Today it's working for core and IRC plugin. Almost all code has been rewritten, so maybe there are new bugs ;)

Known bugs/limits today:

• IRC plugin: not working if WeeChat is currently reconnecting to server
• IRC plugin: all messages queued (anti-fllood when sending to server) are lost during upgrade
• upgrade does not work for xfer plugin

A new script iset.pl is now available. With that script, you can change WeeChat options with better interface than /set.
Help is available with /help iset when script is loaded.

Screenshot:

Updated on 2017-06-26: the script is now obsolete, replaced by the builtin fset plugin.

Filters have been added. This feature replaces old /ignore command for IRC, but is more powerful and is not specific to IRC, it applies on buffer content. With new /filter command, you can ask WeeChat to filter lines displayed, by tags and/or regular expression on content of line. Unlike old /ignore command, the /filter command only hides lines, they are not removed, and you can see them when you want.

To understand filters, you should know what are tags. Each line displayed in a (formated) buffer may have optional tags, which are one or more words for this line. Number of tags is not limited, but should be reasonable (4 or 5 max). Tags are not visible (not displayed in buffer), they are used to filter content of buffers.

IRC plugin uses tags for all messages displayed if they're issued from an IRC server. Tags are: "irc_xxx" where "xxx" is the command received. For example if someone joins IRC channel, line with "--> nick has joined #channel" will have tag "irc_join". For IRC numeric command, tag is "irc_cmd_xxx" where "xxx" is number (3 digits), and second tag is "irc_numeric".

Some examples of filters:

• filter IRC join/part/quit messages (if you find them boring!): /filter add joinquit * irc_join,irc_part,irc_quit *
• filter lines containing word "spam": /filter add spamfilter * * spam
• filter lines containing "weechat sucks" on channel #weechat: /filter add sucks irc.freenode.#weechat * weechat sucks

You can enable/disable filters by /filter command (look at /help filter) or with shortcut key meta + "=".

In a later version, you'll be able to see indicator in status bar, to know if filters are enabled or not, and if something is filtered on current buffer (lines hidden). This will be possible with new bars.