This document lists important changes for each version, that require manual actions. It is recommended to read it when upgrading to a new stable version.

For a complete list of changes, please look at ChangeLog (file ChangeLog in sources).

Version 0.4.3 (2014-02-09)

Colors in messages

The color code for "reverse video" in IRC message has been fixed: now WeeChat uses 0x16 like other clients (and not 0x12 any more).
The code 0x12 is not decoded any more, so if it is received (for example from an old WeeChat version), it is not displayed as reverse video.

The color code for "underlined text" in input line has been fixed: now WeeChat uses 0x1F, the same code sent to IRC server.

The default keys for "reverse video" and "underlined text" have changed:

  • reverse video: key ctrl+c, r is replaced by ctrl+c, v

  • underlined text: key ctrl+c, u is replaced by ctrl+c, _

You can remove the old keys and add the new ones with these commands:

/key unbind ctrl-Cr
/key unbind ctrl-Cu
/key missing

Terminal title

The boolean option weechat.look.set_title has been renamed to weechat.look.window_title and is now a string.

The content is evaluated and the default value is WeeChat ${info:version}.

Only static content should be used in this option, because the title is refreshed only when the option is changed.

New bar item buffer_last_number

The bar item buffer_count now displays the number of opened buffers (each merged buffer counts 1).

The new bar item buffer_last_number displays the highest buffer number currently used.

If you want to display last number in the status bar, replace buffer_count by buffer_last_number in your option

New bar item buffer_zoom

A new bar item has been added: buffer_zoom. The default value for status bar items becomes:

/set "[time],[buffer_count],[buffer_plugin],buffer_number+:+buffer_name+(buffer_modes)+{buffer_nicklist_count}+buffer_zoom+buffer_filter,[lag],[hotlist],completion,scroll"

IRC messages on channel join

The names are not displayed any more by default on channel join (they are in nicklist anyway).

Names can be displayed with the value "353" in option irc.look.display_join_message (which is not in default value).
The value "366" shows only names count on channel.

If you want to display all messages on join (including names), you can do:

/set irc.look.display_join_message "329,332,333,353,366"

Maximum lag in IRC

Option has been added.

The value of option (if set to non-zero value) must be less than or equal to, otherwise the reconnection will never occur.

You should check the value of both options and fix them if needed.

Version 0.4.2 (2013-10-06)

Day change message

The day change message is now dynamically displayed, and therefore is not stored as a line in buffer any more.

Option weechat.look.day_change_time_format has been split into two options weechat.look.day_change_message_{1date|2dates} (color codes are allowed in these options, see /help eval).

New color option weechat.color.chat_day_change has been added.

After /upgrade from an old version, you will see two messages for each day change. This is a normal behavior and will not happen again with the next day changes.

Regex search in buffer

Search with regular expression has been added, and therefore some keys in search context have been changed.

The key ctrl+r in search context is now used to switch string/regex search (instead of searching exact text).

If you never changed keys in search context, you can reset them all with one command:

/key resetall -yes search

Or the manual method:

/key missing search
/key bindctxt search ctrl-R /input search_switch_regex

To view keys in search context:

/key list search

For more information, see the chapter about keys in the WeeChat User’s guide.

New rmodifier

A new rmodifier "secure" has been added to hide passphrase and passwords displayed by command "/secure". Use command /rmodifier missing to add it.

Color codes in options

The format for color codes in some options has changed. The options are evaluated with the function "string_eval_expression", which uses the format ${color:xxx}.

Following options are affected:

  • weechat.look.buffer_time_format

  • weechat.look.prefix_action

  • weechat.look.prefix_error

  • weechat.look.prefix_join

  • weechat.look.prefix_network

  • weechat.look.prefix_quit

The options using old format ${xxx} must be changed with new format ${color:xxx} (where xxx is a color name or number, with optional color attributes).


/set weechat.look.buffer_time_format "${color:251}%H${color:243}%M${color:238}%S"

Binary and man page

WeeChat binary and man page have been renamed from weechat-curses to weechat.

A symbolic link has been added for binary: weechat-cursesweechat (so that the /upgrade from a old version will still work).

If you upgrade from an old version, it is recommended to force the use of the new binary name with the command: /upgrade /path/to/weechat (replace the path accordingly).

For packagers: you should create the link weechat-cursesweechat if it’s not automatically created in the package (both cmake and configure are creating this link on make install).

Man page / documentation

Documentation is not built by default any more, you have to use option -DENABLE_DOC=ON in cmake to enable it.

The man page is now built with asciidoc and translated in several languages. A new cmake option ENABLE_MAN has been added to compile man page (OFF by default).

Aspell colors

Option aspell.look.color has been renamed to aspell.color.misspelled.

Version 0.4.1 (2013-05-20)

Nicklist diff in relay

A new message with identifier "_nicklist_diff" has been added in relay (WeeChat protocol). WeeChat may decide to send full nicklist or this nicklist diff at any time (depending on size of message, the smaller is sent).

Clients using nicklist must implement it.

For more info about content of message, see document WeeChat Relay Protocol.

Dynamic nick prefix/suffix

The nick prefix/suffix (for example: "<" and ">") are now dynamic and used on display (not stored any more in the line).

Options moved from irc plugin (irc.conf) to core (weechat.conf):

  • irc.look.nick_prefix moved to weechat.look.nick_prefix

  • irc.look.nick_suffix moved to weechat.look.nick_suffix

  • irc.color.nick_prefix moved to weechat.color.chat_nick_prefix

  • irc.color.nick_suffix moved to weechat.color.chat_nick_suffix

Types and default values for these four options remain unchanged.

Two new options to customize the truncature char (by default "+"):

  • weechat.look.prefix_align_more_after (boolean, on by default)

  • weechat.look.prefix_buffer_align_more_after (boolean, on by default)

When these options are enabled (default), the "+" is displayed after the text, replacing the space that should be displayed there.
When turned off, the "+" will replace last char of text.

Example for a nicks "FlashCode" and "fc" with different values for options weechat.look.prefix_align_max, weechat.look.prefix_align_more_after, weechat.look.nick_prefix and weechat.look.nick_suffix:

                      # align_max, more_after, prefix/suffix

FlashCode │ test      # 0, on
       fc │ test

FlashCod+│ test       # 8, on
      fc │ test

FlashCo+ │ test       # 8, off
      fc │ test

<FlashCode> │ test    # 0, on,  < >
       <fc> │ test

<FlashC>+│ test       # 8, on,  < >
    <fc> │ test

<Flash+> │ test       # 8, off, < >
    <fc> │ test

After /upgrade, if you set new options to non-empty strings, and if old options were set to non-empty strings too, you will see double prefix/suffix on old messages, this is normal behavior (lines displayed before /upgrade have prefix/suffix saved in prefix, but new lines don’t have them any more).

New options in logger plugin (logger.conf):

  • logger.file.nick_prefix: prefix for nicks in log files (default: empty string)

  • logger.file.nick_suffix: suffix for nicks in log files (default: empty string)

IRC reconnection on important lag

Option has been renamed to and value is now a number of seconds (instead of minutes).

IRC passwords hidden

IRC plugin is now using modifiers "irc_command_auth" and "irc_message_auth" to hide passwords.

The option irc.look.hide_nickserv_pwd has been removed, and a new option irc.look.nicks_hide_password has been added (by default passwords are hidden only for "nickserv").

A new rmodifier "message_auth" has been added to hide passwords displayed by command "/msg nickserv identify|register|ghost|release" and the rmodifier "nickserv" has been renamed to "command_auth".

If you never added/changed rmodifiers, you can just reset all rmodifiers:

/rmodifier default -yes

If you added/changed some rmodifiers, do it manually with these commands:

/rmodifier del nickserv
/rmodifier add command_auth history_add,input_text_display,irc_command_auth 1,4* ^(/(msg|quote) +nickserv +(id|identify|register|ghost \S+|release \S+) +)(.*)
/rmodifier add message_auth irc_message_auth 1,3* ^(.*(id|identify|register|ghost \S+|release \S+) +)(.*)

Lua constants

For consistency with other supported languages, the API constants in Lua have been redefined as constants instead of functions.

Therefore, the use of a constant must be changed: the parentheses must be removed.

The old syntax was:

return weechat.WEECHAT_RC_OK()

The new syntax is:

return weechat.WEECHAT_RC_OK

Guile callbacks

The way to give arguments for guile callbacks has been fixed: now arguments are sent individually (instead of a list with all arguments inside).

Therefore, existing guile scripts must be modified accordingly. Moreover, WeeChat now requires Guile ≥ 2.0 to compile.

Version 0.4.0 (2013-01-20)

Conditions in bars

Conditions in bars have changed, and now an expression is evaluated.

If you have a value with many conditions in a bar, like: nicklist,active, you must now use an expression like: ${nicklist} && ${active} (see the chapter about bars in the WeeChat User’s guide).

IPv6 by default


IPv6 is now used by default to connect to IRC servers, with fallback to IPv4. The option irc.server_default.ipv6 is now "on" by default. If IPv6 is not enabled or fails, IPv4 will be used. The "ipv6" option in server is now used to disable IPv6 and force IPv4 (if option is turned "off").


Relay plugin is now listening by default on an IPv6 socket (new option, on by default), so connections with IPv4 will have IPv4-mapped IPv6 addresses, like: "::ffff:" (for ""); check that value of option supports this mapping, or disable IPv6 in relay if you don’t plan to use it at all:

/set off

Version (2012-11-18)

This version fixes a security vulnerability when a plugin/script gives untrusted command to API function "hook_process".

Version (2012-11-09)

This version fixes crash when decoding IRC colors in strings.

Version 0.3.9 (2012-09-29)

Options moved

Options moved from core (weechat.conf) to irc plugin (irc.conf):

  • weechat.look.nickmode moved to irc.look.nick_mode (new type: integer with values: none/prefix/action/both)

  • weechat.look.nickmode_empty moved to irc.look.nick_mode_empty

New bar item buffer_modes

A new bar item has been added: buffer_modes and irc option irc.look.item_channel_modes has been removed; to display irc channel modes in status bar (after channel name), you have to manually add the new item buffer_modes (this is now used by default in status bar items), default value for status bar items becomes:

/set "[time],[buffer_count],[buffer_plugin],buffer_number+:+buffer_name+(buffer_modes)+{buffer_nicklist_count}+buffer_filter,[lag],[hotlist],completion,scroll"

Command /aspell

New options in command /aspell:

  • enable: enable aspell

  • disable: disable aspell

  • toggle: toggle aspell (new default key: alt+s)

Options renamed in command /aspell:

  • enable renamed to setdict (set dictionary for current buffer)

  • disable renamed to deldict (delete dictionary used on current buffer)

  • dictlist renamed to listdict (show installed dictionaries)

Horizontal separator

An horizontal separator has been added between split windows, and two options have been added to toggle separators (both are enabled by default):

  • weechat.look.window_separator_horizontal

  • weechat.look.window_separator_vertical

New keys

New keys were added, use command /key missing to add them or /key listdiff to see differences between your current keys and WeeChat default keys.

Version 0.3.8 (2012-06-03)


Options weechat.look.prefix_align_more and weechat.look.prefix_buffer_align_more have been converted from type boolean to string:

  • if the value was on (default), new value is "+" and you can now customize this char

  • if the value was off, you have to set " " (string with one space)

Paste detection

Option weechat.look.paste_max_lines can now be used with value 0 to detect paste with one line (only if terminal "bracketed paste mode" is enabled when option weechat.look.paste_bracketed is on); so now the value -1 is used to disable paste detection: if your value was 0, you should set it to -1

/set weechat.look.paste_max_lines -1


Rmodifier "nickserv" has a new default regex which includes option "release" for command "/msg nickserv".

If you never added/changed rmodifiers, you can just reset all rmodifiers:

/rmodifier default -yes

If you added/changed some rmodifiers, do it manually with these commands:

/rmodifier del nickserv
/rmodifier add nickserv history_add,input_text_display 1,4* ^(/(msg|quote) +nickserv +(id|identify|ghost \S+|release \S+) +)(.*)

Version 0.3.7 (2012-02-26)


Option scroll_unread has been moved from command /input to /window, therefore default command of key alt+u has been updated. To bind key with new default value:

/key bind meta-u /window scroll_unread

Option weechat.history.max_lines has been renamed to weechat.history.max_buffer_lines_number.

Option weechat.plugin.extension now supports list of extensions, and new default value is ".so,.dll" (with this value, weechat.conf is compatible with Cygwin).

Extended regex

Extended regex is used in filters and irc ignore, so some chars that needed escape in past do not need any more (for example [0-9]\+ becomes [0-9]+), filters and ignore have to be manually fixed.

Option weechat.look.highlight_regex becomes case insensitive by default, to make it case sensitive, use "(?-i)" at beginning of string, for example: "(?-i)FlashCode|flashy".

Version 0.3.6 (2011-10-22)


Option weechat.look.hline_char has been renamed to weechat.look.separator_horizontal.

Bold in colors

Bold is not used any more for basic colors (used only if terminal has less than 16 colors), a new option has been added to force bold if needed: weechat.look.color_basic_force_bold.

Version 0.3.5 (2011-05-15)


If you have some colors defined in section "palette" with version 0.3.4, you should remove all colors defined, and add new aliases (it’s not needed any more to add colors before using them).

Colors for nick prefixes (char for op, voice, ..) are defined in a single option irc.color.nick_prefixes, therefore following options will be lost: irc.color.nick_prefix_op, irc.color.nick_prefix_halfop, irc.color.nick_prefix_voice, irc.color.nick_prefix_user.



Count of messages have been added to hotlist by default, if you want to come back to old behavior, do that:

/set weechat.look.hotlist_count_max 0
/set weechat.look.hotlist_buffer_separator ","

Away and current buffer

When you are away, all buffers are now added to hotlist by default (even if they are displayed in a window), if you want to come back to old behavior, do that:

/set weechat.look.hotlist_add_buffer_if_away off

New keys

New keys were added, use command /key missing to add them or /key listdiff to see differences between your current keys and WeeChat default keys.

Version 0.3.4 (2011-01-16)

After /upgrade

If you are using /upgrade from a previous release:

  • some nick prefixes can be wrong, so it is recommended to do /allchan names

  • nick colors are defined with a new option weechat.color.chat_nick_colors, therefore old options weechat.color.chat_nick_color1..10 will be lost when upgrading

  • nick colors in messages displayed will be wrong if you changed some nick colors (old default colors will be used)


Some IRC options have been renamed, before upgrading to this version, note value for old options, and set them again with new name:

  • options moved from network section to servers (with global value, and server value, like other server options):

    • moved to irc.server_default.connection_timeout

    • moved to irc.server_default.anti_flood_prio_high

    • moved to irc.server_default.anti_flood_prio_low

    • moved to irc.server_default.away_check

    • moved to irc.server_default.away_check_max_nicks

    • moved to irc.server_default.default_msg_part

    • moved to irc.server_default.default_msg_quit

  • other IRC options renamed:

    • irc.look.open_channel_near_server moved to irc.look.new_channel_position (old option was boolean, new is integer with value as string)

    • irc.look.open_pv_near_server moved to irc.look.new_pv_position (old option was boolean, new is integer with value as string)

Version 0.3.3 (2010-08-07)

After /upgrade

If you are using /upgrade from a previous release, then you must reconnect to IRC servers in order to use new command /wallchops.


Option irc.look.show_away_once has been renamed to irc.look.display_pv_away_once.

Option is now in milliseconds, you should set new value: your current value multiplied by 1000 (new default value is 500).

Version 0.3.2 (2010-04-18)

After /upgrade

If you are using /upgrade from a previous release, then you must execute this command on all IRC servers/channels/private buffers and xfer DCC chats (not needed on WeeChat core buffer or buffers from other plugins/scripts):

/buffer set highlight_words $nick

Version (2010-01-31)

This version fixes crashes with SSL connection and purge of old DCC chats.

All users of version 0.3.1 should upgrade to this version.

Version 0.3.1 (2010-01-23)


IRC commands /ame and /amsg are now aliases, if you are upgrading from version 0.3.0, you must create aliases with following commands:

/alias aaway allserv /away
/alias ame allchan /me
/alias amsg allchan /amsg *
/alias anick allserv /nick

Version 0.3.0 (2009-09-06)

This version brings MAJOR changes, especially for configuration files and plugin API and it not compatible with previous versions.

Major differences:

  • it is NOT POSSIBLE to use command /upgrade from a version 0.2.x to 0.3.x; you have to quit your old WeeChat, then run new version.

  • new configuration files (*.conf) are not compatible with old files (*.rc).

  • name of options is similar to old versions, but there is now one configuration file by plugin, and one file for WeeChat core; there is no automatic conversion for your old options to new configuration files, so you’ll have to setup again your IRC servers and all other options.

  • plugin API has been rewritten and is not compatible with previous versions; accordingly, scripts and plugins must have been designed for version 0.3.x to be loaded into WeeChat.

Version (2009-06-13)

This version fixes gnutls detection.

Version (2009-04-18)

This version fixes a bug with charset decoding (like iso2022jp).

Version (2009-03-14)

This version fixes a major bug: crash with some special chars in IRC messages.

Version 0.2.6 (2007-09-06)

No release note.

Version 0.2.5 (2007-06-07)

No release note.

Version 0.2.4 (2007-03-29)

No release note.

Version 0.2.3 (2007-01-10)

This version fixes several major bugs of version 0.2.2.

All users of version 0.2.2 should upgrade to this version.

Version 0.2.2 (2007-01-06)

Charset plugin

For users of any previous version, all your charset settings in weechat.rc will be LOST! You should save your weechat.rc to keep your values and set them again with new charset plugin.

For ISO users: history of channels may be without accents (after /upgrade), this is not recoverable, but this is not a bug. All new messages should be OK.

Be careful, now default encode is UTF-8 for all channels (before it was terminal charset). If you still want to send messages as ISO-8859-1, you should set either global encode or server specific encode to ISO-8859-1.

For global encode:

/setp = "ISO-8859-1"

For server encode (on server buffer):

/charset encode ISO-8859-1

New keys

New keys for topic scroll: F9/F10.

Key F10 was used for infobar_clear in previous WeeChat versions, you have to manually rebind this key (except for new WeeChat users):

/key <press alt+"k" then F10> scroll_topic_right

Which gives something like:

/key meta2-21~ scroll_topic_right

Version 0.2.1 (2006-10-01)

No release note.

Version 0.2.0 (2006-08-19)

After /upgrade

If you upgraded with /upgrade in WeeChat, you should /disconnect and then /reconnect on each server, to display properly channel/user modes.


If you’re using plugins, you should remove some old plugins libraries in WeeChat system library directory (commonly /usr/local/lib/weechat/plugins): remove lib* files (like libperl.*, libpython.*, ..) and keep only new libraries (perl.*, python.*, ..).

Version 0.1.9 (2006-05-25)

DCC chat

Please close all DCC chat buffers before using /upgrade command, otherwise you may experience problems with DCC chats.

Script API

Some changes in script API: now timer handlers functions takes exactly 0 (zero) argument (in version 0.1.8, two arguments were mandatory but not used: server and arguments).

Version 0.1.8 (2006-03-18)

After /upgrade

After installing 0.1.8 (or with /upgrade), issue both commands (if you didn’t redefine these keys (alt+Home/End):

/key unbind meta-meta2-1~
/key unbind meta-meta2-4~

Then launch again WeeChat (or issue /upgrade).

Configuration files

It is recommended for users of version 0.1.7 (or any older), to replace values in setup file (~/.weechat/weechat.rc):

  • option: log_path: replace ~/.weechat/logs by %h/logs

  • option: plugins_path: replace ~/.weechat/plugins by %h/plugins

The string %h is replaced by WeeChat home (default: ~/.weechat, may be overridden by new command line argument --dir).


Keys alt+Home/End were used for nicklist scroll, they’re now replaced by alt+F11/F12.

Version 0.1.7 (2006-01-14)


Ruby script plugin has been added but is experimental in this release. You’re warned!

Command /away

Command /away was changed to be RFC 2812 compliant. Now argument is required to set away, and no argument means remove away ("back").

Option irc_default_msg_away has been removed.

Version 0.1.6 (2005-11-11)

Script API

Incompatibility with some old scripts: now all handlers have to return a code for completion, and to do some actions about message to ignore (please look at documentation for detail).


On OpenBSD, the new option plugins_extension should be set to .so.0.0 since the plugins names are ending by .so.0.0 and not .so.


With new and full UTF-8 support, the option look_charset_internal should be set to blank for most cases. Forces it only if your locale is not properly detected by WeeChat (you can set UTF-8 or ISO-8859-15 for example, depending on your locale). WeeChat is looking for UTF-8 in your locale name at startup.

Version 0.1.5 (2005-09-24)

No release note.

Version 0.1.4 (2005-07-30)

No release note.

Version 0.1.3 (2005-07-02)

No release note.

Version 0.1.2 (2005-05-21)

No release note.

Version 0.1.1 (2005-03-20)

No release note.

Version 0.1.0 (2005-02-12)

No release note.

Version 0.0.9 (2005-01-01)

No release note.

Version 0.0.8 (2004-10-30)

No release note.

Version 0.0.7 (2004-08-08)

No release note.

Version 0.0.6 (2004-06-05)

No release note.

Version 0.0.5 (2004-02-07)

No release note.

Version 0.0.4 (2004-01-01)

No release note.

Version 0.0.3 (2003-11-03)

No release note.

Version 0.0.2 (2003-10-05)

No release note.

Version 0.0.1 (2003-09-27)

No release note.