WeeChat DevCenter

Sunday, September 28 2014

Version 1.0.1

Version 1.0.1 is available!

This is a bug fix and maintenance release, see ChangeLog for detail.

Friday, August 15 2014

Version 1.0

Yay, version 1.0 is available!

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

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

New major features in this release:

  • plugin "trigger": Swiss Army knife for WeeChat (replaces "rmodifier" plugin)
  • plugin "exec": execute external commands (replaces script "shell.py")
  • bare display: easy click on long URLs and text selection with mouse
  • support of environment variables in /set command
  • hidden buffers
  • negated tags in filters
  • toggle of filters in specific buffers
  • flexible conditions for adding/removing buffers in hotlist
  • text search in buffers with free content
  • support of wildcard "*" inside masks
  • support of nested variables in evaluated expressions
  • tag with host in IRC messages displayed
  • support of "away-notify" IRC capability
  • IRC commands: /allpv, /remove, /unquiet
  • bar items: buffer_short_name, irc_nick_modes
  • unit tests

New options:

  • irc.color.item_nick_modes
  • irc.look.join_auto_add_chantype
  • relay.network.clients_purge_delay
  • weechat.color.status_nicklist_count
  • weechat.look.bare_display_exit_on_input
  • weechat.look.bare_display_time_format
  • weechat.look.hotlist_add_conditions (replaces weechat.look.hotlist_add_buffer_if_away)
  • weechat.look.hotlist_remove

Options changed:

  • irc.look.item_channel_modes_hide_key renamed to irc.look.item_channel_modes_hide_args

New keys:

  • alt-"-": toggle filters in current buffer
  • alt-"l" (L): bare display
  • alt-"j", alt-"f": jump to first buffer

Friday, March 28 2014

Source code of weechat.org

The source code of weechat.org is now available on GitHub: https://github.com/weechat/weechat.org.

It is written in Python and uses Django, and gettext for translations.

Designers, Python/Django developers and especially translators are welcome!

Saturday, March 15 2014

Exec plugin

A new plugin called "exec" has been added, with command /exec.

The command /exec can execute external commands and display output in WeeChat.

It is similar to /shell (script shell.py), with major improvements:

  • run many commands at once,
  • send signals to commands,
  • send data on stdin of a command,
  • line numbers in output,
  • ANSI color support,
  • command timeout.

Other features coming soon: pipe output to WeeChat command or hsignal (to use in a trigger).

Monday, March 3 2014

Git repositories moved to GitHub

WeeChat git repositories (weechat, scripts, qweechat) have been moved to GitHub, in WeeChat organization: http://github.com/weechat.
The git repositories on savannah are not updated any more (and will be removed in near future).

The GitHub issue tracker can now be used to report bugs and ask for feature requests.
If the bug/task already exists in Savannah, you can complete/discuss it on Savannah, no need to open a new one on GitHub.

Pull requests are welcome in all repositories, including scripts (except for adding a script, the form on weechat.org must be used).

A page with examples of triggers has been added in weechat wiki.

Sunday, February 16 2014

Bare display

A "bare" display mode has been added. This special mode displays only the current buffer, and no bars around (no title, nicklist, status, input, ...).
It is designed for easy selection of text and click on long URLs (which are not broken at the end of lines, because ncurses is disabled in this mode).

A new key has been added: alt-"l" (use /key missing to add the key), or this command: /key bind meta-l /window bare.
You can also use a delay in seconds with command /window bare, for example 5 seconds: /window bare 5.

Two options have been added:

  • weechat.look.bare_display_exit_on_input (default: on): by default any changes in input will return to standard display
  • weechat.look.bare_display_time_format (default: "%H:%M"): the format of time used in bare display.

Bare display looks like this (click for full size):


Monday, February 10 2014

Trigger plugin

A new plugin called "trigger" has been added.

This plugin can hook many things:

  • signal
  • hsignal
  • modifier
  • print
  • command
  • command_run
  • timer
  • config
  • focus

When the callback is called, trigger can:

  • check some conditions (to execute the trigger or not), which are evaluated (see /help eval)
  • replace some text using regular expression(s)
  • execute command(s)
  • have a custom return code.

Example of things you can do with trigger:

  • notification, for example beep on highlight/private message (it can replace script beep.pl or other scripts)
  • hide passwords in commands/messages (it will replace rmodifier plugin)
  • change content of messages displayed
  • change things displayed (nicklist, ...) when terminal becomes small
  • regularly save config files (with a timer)
  • ...

Help is available with /help trigger.

Some examples of triggers can be found on GitHub WeeChat wiki.

Sunday, February 9 2014

Version 0.4.3

Version 0.4.3 is available!

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

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

New major features in this release:

  • new command /print
  • logical and/or for tags in /filter and hook_print
  • gaps in buffer numbers
  • support of italic text
  • new options to customize default text search in buffers
  • use of IRC monitor command for /notify (if available on server)
  • new IRC server option "ssl_fingerprint"
  • new option to smart-filter IRC mode messages
  • new option for default IRC ban mask
  • support of IPv6 for DCC chat/file
  • auto check CRC32 of files received with DCC

New options:

  • irc.look.notice_welcome_tags
  • irc.look.smart_filter_mode
  • irc.network.ban_mask_default
  • irc.network.lag_max
  • irc.server.xxx.default_msg_kick
  • irc.server.xxx.ssl_fingerprint
  • weechat.look.buffer_auto_renumber
  • weechat.look.buffer_position
  • weechat.look.buffer_search_case_sensitive
  • weechat.look.buffer_search_force_default
  • weechat.look.buffer_search_regex
  • weechat.look.buffer_search_where
  • weechat.look.item_buffer_zoom
  • weechat.look.tab_width
  • weechat.look.window_auto_zoom
  • xfer.file.auto_check_crc32

Options changed:

  • irc.look.highlight_tags renamed to irc.look.highlight_tags_restrict
  • weechat.look.set_title renamed to weechat.look.window_title

New keys:

  • ctrl-C, "v": reverse video (replaces ctrl-C, "r")
  • ctrl-C, "_": underlined text (replaces ctrl-C, "u")

Thursday, January 9 2014

CRC32 and IPv6 in xfer plugin

CRC32 and IPv6 are now supported in xfer plugin!

For CRC32, a new option has been added:

  • xfer.file.auto_check_crc32 (boolean, off by default): when enabled, if the filename has a CRC32 (8 hexadecimal chars with delimiters around), the CRC32 of file content is checked and the result is displayed in xfer buffer (with error in core buffer if the CRC32 is wrong).

For IPv6, everything is automatic; it works for DCC file and chat.

Note for C plugin developers: the function "weechat_network_connect_to" has been modified to be used with IPv6. See the plugin API reference for more info.

A big thanks to Andrew Potter for the patches!


Wednesday, December 11 2013

Auto renumber of buffers

Auto renumber of buffers can now be disabled.

Two options have been added:

  • weechat.look.buffer_auto_renumber
  • weechat.look.buffer_position

A bar item has beed added as well:

  • buffer_last_number

When auto renumber is disabled, gaps between buffer numbers are allowed and the first buffer can have a number greater than 1.

Following options for command /buffer are affected when auto renumber is off:

  • move:
    • the current number will be left free for use, and the target number can be any number >= 1 (possibly higher than the current last buffer number)
    • the value can be "-" (which moves the buffer to number 1) or "+" (which moves the buffer to the end, ie last number + 1)
  • swap:
    • now the buffers are swapped in the list without being "moved"
  • +/-N:
    • it is now working with gaps in buffer numbers
  • merge:
    • it can now merge a group of merged buffers into another buffer (or buffers merged themselves)

Sunday, October 6 2013

Version 0.4.2

Version 0.4.2 is available!

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

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

New major features in this release:

  • rename binary from "weechat-curses" to "weechat" (with symbolic link "weechat-curses" for compatibility) (see this post)
  • add secured data (encryption of passwords or private data), new command /secure, new file sec.conf (see this post)
  • search of regular expression in buffer with text emphasis, in prefixes, messages or both (see this post)
  • add option "scroll_beyond_end" for command /window
  • add optional buffer context in bar items (for example to display bitlbee nicklist in a root bar)
  • new options weechat.look.hotlist_{prefix|suffix}
  • new option weechat.look.key_bind_safe to prevent any key binding error from user
  • new option weechat.network.proxy_curl to use a proxy when downloading URLs with curl
  • display day change message dynamically
  • support of wildcards in IRC commands (de)op/halfop/voice
  • new option irc.look.notice_welcome_redirect to redirect channel welcome notices to the channel buffer
  • new option irc.look.nick_color_hash: new hash algorithm to find nick colors (variant of djb2)
  • add info about things defined by a script in the detailed view of script (/script show)
  • support of enchant library in aspell plugin

New options:

  • aspell.color.suggestions
  • irc.look.nick_color_hash
  • irc.look.notice_welcome_redirect
  • irc.look.pv_tags
  • sec.crypt.cipher
  • sec.crypt.hash_algo
  • sec.crypt.passphrase_file
  • sec.crypt.salt
  • weechat.color.chat_day_change
  • weechat.color.emphasized
  • weechat.color.emphasized_bg
  • weechat.look.emphasized_attributes
  • weechat.look.hotlist_prefix
  • weechat.look.hotlist_suffix
  • weechat.look.key_bind_safe
  • weechat.network.proxy_curl
  • xfer.look.pv_tags

Options changed:

  • aspell.look.color renamed to aspell.color.misspelled
  • weechat.look.day_change_time_format split into two options: weechat.look.day_change_message_1date and weechat.look.day_change_message_2dates

New keys:

  • in search context (ctrl-R):
    • ctrl-I (tab): search in prefixes, messages or both
    • ctrl-R: search text/regex
    • alt-c: case (in)sensitive search

Saturday, August 17 2013

Search with regex and text emphasis

When searching text in buffer (with ctrl-R), the matching text in lines is now emphasized, even if there are color codes in the line.

The search has been improved: it is now possible to search with a regular expression, and select where to search: in messages (default), prefixes or prefixes+messages.

The default key for search is still ctrl+R and keys have been added/changed in the search context:

  • ctrl-R: switch search type: string/regex
  • alt-c: switch exact case for search
  • tab: switch search in messages/prefixes

The new search prompt in input bar looks like this: [Search (~ str,msg)]

Short description of content:

  • ~: case insensitive search (default)
  • ==: case sensitive search
  • str: search string (default)
  • regex: search regular expression
  • msg: search in messages (default)
  • pre: search in prefixes
  • pre|msg: search in prefixes and messages

Happy search!


Sunday, August 4 2013

Secured data

Secured data has been added to WeeChat: you can now encrypt your passwords or private data in a new configuration file called "sec.conf".

This configuration file is read before any other file, and the values stored inside can be used in various WeeChat or plugins/scripts options.

To add secured data, you just have to set a passphrase (not mandatory, but recommended: this will encrypt data in sec.conf instead of plain text), and then add data, for example :

/secure passphrase this is my passphrase
/secure set freenode mypassword

And then you can use that in a server password, for example :

/set irc.server.freenode.sasl_password "${sec.data.freenode}"

For more info, see /help secure.

Options for encryption

You can use different cipher/hash algorithms, by setting following options:

  • sec.crypt.hash_algo: algorithm for hash: sha224, sha256 (default), sha384, sha512
  • sec.crypt.cipher: cipher: aes128, aes192, aes256 (default)
  • sec.crypt.salt: use salt (recommended for maximum security)
  • sec.crypt.passphrase_file: file with the passphrase (optional)

Note: the cipher block mode is CFB.

The encryption

It is done in 3 steps:

  1. derive a key from the passphrase (with optional salt)
  2. compute hash of data to encrypt
  3. encrypt the hash + data (output is: salt + encrypted hash/data)

The result is put as hexadecimal string in file sec.conf.

The decryption

It is done in 3 steps:

  1. derive a key using salt and passphrase
  2. decrypt hash + data
  3. check that decrypted hash == hash of data

Friday, August 2 2013

Binary and man page renamed

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

You can read important info about that in release notes.

Wednesday, June 26 2013

Happy birthday WeeChat!

Happy birthday WeeChat, 10 years old!

I would like to thank all contributors for the help with translations, patches and ideas of features.
All contributions and donations are much appreciated!

Monday, May 20 2013

Version 0.4.1

Version 0.4.1 is available!

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

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

New major features in this release:

  • multiple layouts support (see this post)
  • nick prefix/suffix are now dynamic (and managed by core instead of irc plugin) (see this post)
  • unmask irc join if nick speaks some minutes after the join (see this post)
  • new option irc.look.display_join_message to disable some messages after joining a channel
  • new option irc.look.pv_buffer to automatically merge private buffers
  • add support of UHNAMES
  • add DH-AES encryption method for SASL
  • multiple irc servers allowed on same port for irc protocol in relay plugin
  • add WebSocket server support (RFC 6455) in relay plugin (for irc and weechat protocols) (see this post)
  • send nicklist diff in relay plugin (weechat protocol)
  • add control of autoload for scripts
  • optimizations in aspell plugin

New options:

  • irc.look.display_join_message
  • irc.look.nicks_hide_password (old option: irc.look.hide_nickserv_pwd)
  • irc.look.pv_buffer
  • irc.look.smart_filter_join_unmask
  • irc.network.lag_reconnect (old option: irc.network.lag_disconnect)
  • logger.file.nick_prefix
  • logger.file.nick_suffix
  • relay.network.websocket_allowed_origins
  • script.scripts.autoload
  • weechat.color.chat_nick_prefix
  • weechat.color.chat_nick_suffix
  • weechat.look.nick_prefix
  • weechat.look.nick_suffix
  • weechat.look.prefix_align_more_after
  • weechat.look.prefix_buffer_align_more_after
  • xfer.file.auto_accept_nicks

Wednesday, May 1 2013

Dynamic nick prefix/suffix

The prefix and suffix for nicks are now dynamic and not specific to irc plugin.

IRC options have been moved to core:

  • 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

The prefix/suffix and colors are now applied on messages already displayed (because they are not stored any more in prefix of lines).

Two options have been added in logger plugin, to use a prefix/suffix for nicks (optional, empty by default):

  • logger.file.nick_prefix
  • logger.file.nick_suffix

You can find more information in release notes.

Sunday, March 17 2013

Multiple layouts

Support of multiple layouts has been added.

The command /layout now supports a name for actions save/apply/reset.

New options have been added:

  • leave: leave current layout (it will not update any layout)
  • rename: rename a layout

The output of /layout has been improved, especially the tree of windows:

Saved layouts:
    1. core.weechat
    1. irc.server.local
    2. irc.local.#test
    3. irc.local.#test2
  desktop (current layout):
    1. core.weechat
    1. irc.server.local
    2. irc.local.#test
    3. irc.local.#test2
    \== 40% (splith)
      |-- irc.local.#test
      |== 50% (splitv)
        |-- irc.server.local
        |-- irc.local.#test2

Sunday, February 17 2013

The IRC smart filter... even smarter!

A new option has been added for the IRC smart filter: irc.look.smart_filter_join_unmask, with default value 30 (in minutes).

IRC plugin will automatically unmask a filtered join of a nick, if he spoke within N minutes after the join (N being the value of new option irc.look.smart_filter_join_unmask). Moreover, nick changes are tracked, and will be unmasked with the join.

Events triggering the unmask of join are: a message (can be CTCP), a notice or an update of topic.

Wednesday, February 13 2013

Debian/Raspbian repositories

A Raspbian repository has been added for Raspberry Pi (thanks to Nils G. for building the packages every night).

The existing Debian repositories are being moved from flashtux.org to weechat.org, like the new Raspbian one. Repositories on weechat.org are already available, therefore it is recommended to use them now.

IMPORTANT: the WeeChat packages on debian.flashtux.org are still built every night, but they will be definitely removed on 2013-03-01.

A new section has been added on download page with a summary of all repositories: http://weechat.org/download/debian/.


Sunday, February 10 2013

WebSocket in relay plugin

Websocket has been added in relay plugin, for IRC and WeeChat protocols.

It is an experimental and partial implementation of RFC 6455: fragmentation and control frames are not yet supported.

The relay plugin automatically detects WebSocket handshake and if everything is OK (origin allowed and required headers received), an answer to handshake is sent and then socket is ready to send/receive WebSocket frames.

Text and binary data are supported, so IRC (text/text) and WeeChat (text/binary) protocols are supported.

Screenshot (click for full size):


Tuesday, February 5 2013

Test script for relay protocol

A test script called testproto.py has been added in QWeeChat to test the relay protocol with WeeChat. This script runs in terminal and does not require Qt.

Script is located in path src/qweechat/weechat/testproto.py of QWeeChat repository.

Screenshot (click for full size):


Sunday, January 20 2013

Version 0.4.0

Version 0.4.0 is available!

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

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

New major features in this release:

  • add option "diff" for command /set, display default values in output of /set
  • add color support in prefix options
  • add command /eval, use expression in conditions for bars
  • connect by default with IPv6 to servers with fallback to IPv4
  • add aspell suggestions
  • add support of tags in irc messages and "server-time" capability (see this post)
  • add irc command /quiet
  • add support of IPv6 in relay plugin
  • add backlog for irc protocol in relay plugin (see this post)
  • display remote IP address for DCC chat/file in xfer plugin
  • add git version in build (see this post)

New options:

  • aspell.check.suggestions
  • irc.network.alternate_nick
  • irc.network.whois_double_nick
  • relay.network.ipv6
  • relay.irc.backlog_minutes
  • relay.irc.backlog_max_number
  • relay.irc.backlog_since_last_disconnect
  • relay.irc.backlog_tags
  • relay.irc.backlog_time_format

Monday, December 24 2012

Backlog for irc protocol in relay

Backlog has been added for irc protocol in relay plugin.

The relay plugin now supports server capability "server-time", to include the messages time as tag (not in the message itself).

5 new options have been added:

  • relay.irc.backlog_max_minutes
  • relay.irc.backlog_max_number
  • relay.irc.backlog_since_last_disconnect
  • relay.irc.backlog_tags
  • relay.irc.backlog_time_format

Enjoy, and merry Christmas!

Wednesday, December 19 2012

Git version in build

The git version (output of "git describe") has been added to WeeChat build. This version is displayed in /version (or /v), and is returned in IRC CTCP ("version" and "finger").

Note: the git version is set only when building a development version (not a stable release).

This is useful if you help people and want to know the exact version.



Tuesday, November 27 2012

Tags in IRC messages

Tags in IRC messages are now supported (in development version, planned for version 0.4.0), following this specification: http://ircv3.atheme.org/specification/message-tags-3.2.

The tag "time" is now read and is used to set the time for the message displayed.

The "znc" IRC bouncer is using this tag with the capability "znc.in/server-time-iso" (name should change in the next release). For example if you are using a server called "znc" in WeeChat, you can do:

/set irc.server.znc.capabilities "znc.in/server-time-iso"

Note: with znc 1.0, the server capability was "znc.in/server-time". With znc git > 1.0, the capability is "znc.in/server-time-iso".

Some info about capability "server-time": https://github.com/atheme/ircv3-specifications/blob/master/extensions/server-time-3.2.

Sunday, November 18 2012


Version is available, it fixes a security problem: untrusted command for function hook_process could lead to execution of commands, because of shell expansions.

Upgrade is highly recommended for all users.

Friday, November 9 2012


Version is available, it fixes a security problem (buffer overflow when decoding IRC colors in strings).

Upgrade is recommended for all users.

Saturday, September 29 2012

Version 0.3.9

Version 0.3.9 is available!

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

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

New major features in this release:

  • add plugin "script" (replacement of weeget.py and script.pl) (see this post)
  • add support of SSL in relay plugin (see this post)
  • add color for offline nicks
  • add system resource limits for WeeChat process
  • add zoom on merged buffer (default key: alt+"x")
  • add "Day changed to" in logger backlog
  • add command line option "-r" (or "--run-command") to run command(s) after startup of WeeChat
  • add option "swap" for command /buffer
  • generate alternate IRC nicks dynamically (when all nicks are already in use)
  • fix rejoin of password protected IRC channels
  • fix freeze in irc and relay plugins with sockets
  • fix color of long lines (displayed on more than one line on screen) under FreeBSD
  • allow update for some variables of hdata
  • add japanese user's guide, scripting guide and tester's guide

New options:

  • weechat.startup.sys_rlimit
  • weechat.look.jump_smart_back_to_buffer
  • weechat.look.window_separator_horizontal
  • weechat.look.window_separator_vertical
  • weechat.look.color_nick_offline
  • weechat.color.chat_nick_offline_highlight
  • weechat.color.chat_nick_offline_highlight_bg
  • aspell.check.enabled
  • irc.look.ctcp_time_format
  • relay.network.ssl_cert_key
  • relay.color.client

Options changed:

  • weechat.look.nickmode renamed as irc.look.nick_mode (new type: integer with values: none/prefix/action/both)
  • weechat.look.nickmode_empty renamed as irc.look.nick_mode_empty

Options removed:

  • irc.look.item_channel_modes

New keys:

  • meta-x = "/input zoom_merged_buffer" (zoom on merged buffer)
  • meta-s = "/mute aspell toggle" (toggle aspell)

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

Tuesday, August 14 2012

Scripts manager

A new scripts manager has been added, the plugin is called "script" and provides the /script command.

This plugin will replace two scripts: weeget.py (the current scripts manager) and script.pl (providing a /script command to load/unload/reload scripts for any language).

The new /script command is similar to command /weeget with some minor differences (see /help script for more info).

The plugin provides a buffer with list of scripts in repository, which makes installation or removal of scripts very fast: just press alt+i on this buffer, and the script is installed! Not satisfied with the script? Key alt+r and the script is gone!

The buffer allows you to search string in scripts (description, tags, ...) and to sort scripts with many keys. Columns displayed can be fully customized (order, columns displayed), as well as colors.

For list of options, just do: /set script.*

List of scripts (click for full size):

Script plugin: list of scripts

Detail of a script (click for full size): Script plugin: detail of a script


Friday, July 27 2012

SSL in Relay plugin

SSL support has been added in Relay plugin, for irc and weechat protocols.

A new option has been added to set the certificate and private key to use:

  • relay.network.ssl_cert_key: path to file with certificate and private key (default: ~/.weechat/ssl/relay.pem)

The file can be created with following commands:

$ mkdir -p ~/.weechat/ssl
$ cd ~/.weechat/ssl
$ openssl req -nodes -newkey rsa:2048 -keyout relay.pem -x509 -days 365 -out relay.pem

In WeeChat :

/relay sslcertkey

And add relays with SSL, for example:

/relay add ssl.irc.freenode 8001
/relay add ssl.weechat 9001

And now WeeChat will serve clients on these ports using SSL, enjoy!

Sunday, June 3 2012

Version 0.3.8

Version 0.3.8 is available!

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

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

New major features in this release:

  • add terminal "bracketed paste mode" (see this post)
  • add IRC "external" SASL mechanism
  • improve parsing of IRC channel modes (do not send extra command "MODE" to server)
  • follow symbolic links for configuration files (*.conf)
  • new option weechat.look.prefix_same_nick (hide same prefix for multiple consecutive messages from same nick)
  • add colors for backlog lines
  • redirect IRC messages from clients to hide output (relay plugin, IRC protocol)
  • add a connection timeout for child process in hook_connect
  • fix display bugs and crashs with small windows
  • fix truncated configuration files (zero-length) after system crash

New options:

  • logger.color.backlog_line
  • logger.color.backlog_end
  • weechat.look.paste_bracketed
  • weechat.look.paste_bracketed_timer_delay
  • weechat.look.prefix_same_nick
  • weechat.network.connection_timeout

Options changed:

  • weechat.look.prefix_align_more (from boolean to string)
  • weechat.look.prefix_buffer_align_more (from boolean to string)

New keys:

  • meta2-200~ = "/input paste_start" (start of bracketed paste)
  • meta2-201~ = "/input paste_stop" (end of bracketed paste)

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

Sunday, March 25 2012

4000 commits

I just made the 4000th commit for WeeChat, which is also the 600th commit for the past 12 months!

Commits by range: month: 56 year: 600 total: 4000

New page with statistics about Git repositories (core and scripts): http://weechat.org/dev/stats

Friday, March 16 2012


A new script samegame.py is now available! More info about this game is available at http://en.wikipedia.org/wiki/SameGame.

If you are using weeget, just do: /weeget install samegame.py

Mouse is required, so you must have WeeChat >= 0.3.6.

For help: /help samegame.

Screenshot (click for full size):



Saturday, March 10 2012

Bracketed paste mode

The support for terminal bracketed paste mode has been added. In this mode, pasted text is bracketed with control sequences so that WeeChat can differentiate pasted text from typed-in text (ESC[200~, followed by the pasted text, followed by ESC[201~).

New options:

  • weechat.look.paste_bracketed: enable terminal "bracketed paste mode" (off by default)
  • weechat.look.paste_bracketed_timer_delay: force end of bracketed paste after this delay (in seconds) if control sequence for end of bracketed paste was not received in time (10 seconds by default)

Changes on option weechat.look.paste_max_lines: now -1 is used to disable option (and new default value is 1 instead of 3). According to value, you have following behaviour:

  • value -1: paste detection disabled (any paste is immediately inserted in input, without confirmation)
  • value 0: WeeChat will ask confirmation for any paste (even one char)
  • value N (>= 1): WeeChat will ask for at least N+1 lines

When pasting one line with newline in bracketed paste mode, the newline at the end of paste is automatically removed (regardless the value of option weechat.look.paste_max_lines).

According to my tests the "bracketed paste mode" works fine with:

  • terminals: rxvt-unicode (9.15), xterm (276), mintty (1.0.3)
  • multiplexer: screen (4.00.03)

According to my tests it currently does not work with:

  • terminals: putty like (planned, committed recently)
  • multiplexer: tmux (1.6) (planned, committed recently)

Please comment this post if you have info about other terminals (supported or not).

Sunday, February 26 2012

Version 0.3.7

Version 0.3.7 is available!

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

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

New major features in this release:

  • support of Scheme scripts (new plugin "guile") (see this post)
  • support of Python 3.x (but version 2.x still recommended) (see this post)
  • add "weechat" protocol in relay plugin for remote interfaces, like QWeeChat (see this post)
  • new option irc.color.mirc_remap to remap mirc colors in irc messages
  • new options irc.look.highlight_{server|channel|pv} to customize or disable default nick highlight
  • new option "capabilities" in irc servers (to enable some client capabilities on connection)
  • new option weechat.history.max_buffer_lines_minutes to limit buffer history by time
  • use extended regex in /filter, /ignore and /list
  • add support of flags in regular expressions and highlight options
  • add URL transfer in plugin API (with hook_process) (see this post)
  • add translations in japanese
  • add doc for relay protocol
  • add developer's guide

New options:

  • irc.look.highlight_server
  • irc.look.highlight_channel
  • irc.look.highlight_pv
  • irc.look.mirc_remap
  • irc.server.xxx.capabilities
  • relay.network.allowed_ips
  • relay.network.compression_level
  • weechat.look.scroll_bottom_after_switch
  • weechat.completion.base_word_until_cursor
  • weechat.history.max_buffer_lines_minutes
  • weechat.history.max_buffer_lines_number (old name was weechat.history.max_lines)

New default alias:

  • /umode --> /mode $nick

New keys:

  • alt + "/": jump to last buffer displayed (/input jump_last_buffer_displayed)

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

Wednesday, January 18 2012

URL transfer in API

URL transfer has been added in API for plugins and scripts (using libcurl).

A new function has been added: "hook_process_hashtable". Behaviour is the same as "hook_process", but with an extra "options" (a hashtable). To download URL content (html page or file), the syntax is (example is python):

                               { 'file_out': '/tmp/url.txt' },
                               10000, 'my_process_cb', '')

This code will download URL in file "/tmp/url.txt" and call function "my_process_cb" when done, with return code:

  • 0: transfer ok
  • 1: invalid URL
  • 2: transfer error
  • 3: not enough memory
  • 4: error with a file

It is possible to download URL without any option, then the output is on standard output of process (received as "out" in callback, possibly in many chunks, depending on page size):

weechat.hook_process('url:http://weechat.org/download/', 10000, 'my_process_cb', '')

Tuesday, January 3 2012

Support of Python 3

WeeChat can now compile with Python 3.x (successfully tested with Python 3.1 and 3.2).
This is still experimental and recommended Python for WeeChat remains version 2.7.

Some scripts (including weeget.py) have been updated for Python 3.x, they have tag "py3k-ok" on the scripts page: http://weechat.org/scripts/stable/tag/py3k-ok/

Python versions supported by WeeChat:

  • 2.5: many scripts require at least 2.6 - NOT recommended
  • 2.6: all scripts should work fine
  • 2.7: recommended version (all scripts are guaranteed to work with this version)
  • 3.x: experimental, should be used only for tests

Note that "python" plugin in WeeChat can support only one version, so it can be a 2.x or 3.x, not both at same time.

Sunday, December 25 2011

QWeeChat - Python/Qt GUI

Christmas gift: "QWeeChat", the first remote interface for WeeChat. It is written in Python, using Qt toolkit.

This is an alpha version of this interface, only some features are implemented, but it's usable as-is.

The source code is available on download page, and requires latest development version of WeeChat.
New versions will follow, as well as interfaces for other systems like mobile devices (first should be Android).

A screenshot of QWeeChat in action (click for full size):


Merry Christmas and happy new year 2012 with WeeChat and QWeeChat!

Tuesday, November 1 2011

So many ways to go to first buffer...

  1. key alt+1
  2. key alt+j, then 0, then 1
  3. key F5 *
  4. key F6 *
  5. key ctrl-p *
  6. key ctrl-n *
  7. key alt+left *
  8. key alt+right *
  9. key alt+up *
  10. key alt+down *
  11. key alt+a (if buffer #1 is first in hotlist)
  12. left mouse button with long gesture to the left (with mouse enabled)
  13. command /buffer 1
  14. command /buffer core.weechat (if core buffer is #1)
  15. command /buffer close 2-99999 (joke! - this will destroy all buffers and keep only buffer(s) with number 1)
  16. command /buffer move 1 (joke! - current buffer will become #1)

There are other ways with scripts, but it's cheating!

* : press key many times until you reach buffer #1.

Monday, October 31 2011

Shorten URLs with own HTTP server

Don't panic with long URLs and don't give your private URLs any more to shortening services!
A new script urlserver.py has been added. This script shortens URLs displayed and serve them using own HTTP server, which can be used to display a list of all URLs as well.

Many options are available to customize shortening of URLs, display in WeeChat and HTML page (see /help urlserver and /set plugins.var.python.urlserver.*).

The URLs are saved into ~/.weechat/urlserver_list.txt when script is unloaded, so that URLs are persistent when you restart WeeChat.

A screenshot of HTML page with list of URLs (click for full size):


Friday, October 28 2011

Change short name of buffers

The short name of buffers can be changed with /buffer set short_name <new_name> command. This might be useful for long channel names displayed in the buffers bar (with script buffers.pl).

For example on channel #weechat:

/buffer set short_name #wee

New value is used immediately, but is not saved in config file. To make it persistent, you have to use script buffer_autoset.py:

/autosetbuffer add irc.freenode.#weechat short_name #wee

Note1: it's not recommended to set short name of query buffers, because WeeChat will change name of buffer when nick changes.

Note2: you should use command /buffer set with precautions, it is not recommended to change other buffer properties if you're not sure about what you do. This could lead to weird behaviour or a crash.

Thursday, October 27 2011

New plugin Guile

A new plugin called "guile" has been added to WeeChat. You can now load and execute Scheme scripts in WeeChat!

WeeChat now supports Python, Perl, Ruby, Lua, Tcl and Guile!

To load/unload scheme scripts, command is /guile with same syntax as other script languages:

/guile load /path/to/example.scm
/guile reload example
/guile unload example

An example of script:

;; example.scm
(weechat:register "example" "FlashCode" "0.1" "GPL3" "Scheme script" "" "")
(weechat:print "" "Hey, I'm a scheme script for WeeChat!")

Saturday, October 22 2011

Version 0.3.6

Version 0.3.6 is available!

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

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

New major features in this release:

  • mouse support (see this post)
  • cursor mode (free movement of cursor on screen)
  • contexts for keys (default, search, cursor, mouse)
  • hdata in API (direct access to WeeChat data)
  • "inactive" colors for inactive windows and lines in merged buffers (see this post)
  • support of merged buffers in /layout, save layout of buffers/windows on /upgrade (see this post)
  • horizontal scrolling in buffers with free content
  • split of outgoing IRC messages
  • options for "more" chars in bars
  • bold not used any more for basic colors (if terminal has more than 16 colors)
  • automatic zoom on current window when terminal becomes too small for windows
  • new command /repeat
  • local variable "highlight_regex" in buffers

New options:

  • weechat.look.bar_more_down
  • weechat.look.bar_more_left
  • weechat.look.bar_more_right
  • weechat.look.bar_more_up
  • weechat.look.color_basic_force_bold
  • weechat.look.color_inactive_buffer
  • weechat.look.color_inactive_message
  • weechat.look.color_inactive_prefix
  • weechat.look.color_inactive_prefix_buffer
  • weechat.look.color_inactive_time
  • weechat.look.color_inactive_window
  • weechat.look.eat_newline_glitch
  • weechat.look.item_buffer_filter
  • weechat.look.mouse
  • weechat.look.mouse_timer_delay
  • weechat.look.separator_horizontal
  • weechat.look.separator_vertical
  • weechat.color.chat_inactive_buffer
  • weechat.color.chat_inactive_window
  • weechat.color.chat_prefix_buffer_inactive_buffer
  • weechat.color.chat_tags
  • logger.file.flush_delay

New keys:

  • alt + "m": toggle mouse (/mouse toggle)

New keys have been added for context "cursor" and "mouse", please see documentation.

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

Sunday, October 2 2011

Game Minesweeper

A new script minesweeper.py is now available, the famous Minesweeper game!

If you are using weeget, just do: /weeget install minesweeper.py

256 colors mode is highly recommended, and mouse support (with WeeChat >= 0.3.6). If you have 16 colors or less, you can do: /minesweeper 16col

For help: /help minesweeper.

Screenshot (click for full size):



Friday, September 23 2011

Inactive colors

New "inactive" colors have been added, to use a different text color for inactive windows or inactive lines (lines from merged buffer which is not selected).

Some options have been added to control display of inactive color, and of course inactive color themselves.

The first two options control wheter inactive colors are used for inactive windows or inactive lines in merged buffers:

  • /set weechat.look.color_inactive_window (default: off)
  • /set weechat.look.color_inactive_buffer (default: off)

Some options are used to specify if time/prefix_buffer/prefix/message will use inactive colors or not:

  • /set weechat.look.color_inactive_time (default: off)
  • /set weechat.look.color_inactive_prefix_buffer (default: on)
  • /set weechat.look.color_inactive_prefix (default: on)
  • /set weechat.look.color_inactive_message (default: on)

And finally, the three new colors used for inactive windows and inactive lines in merged buffers:

  • /set weechat.color.chat_inactive_window (default: darkgray, suggested: 245)
  • /set weechat.color.chat_inactive_buffer (default: darkgray, suggested: 245)
  • /set weechat.color.chat_prefix_buffer_inactive_buffer (default: darkgray, suggested: 58)

Sunday, August 28 2011

Beautify your WeeChat

Some tips to beautify your WeeChat, using unicode chars and some colors.

Unicode chars (your locale must be UTF-8)

A full line for separator between prefix (usually nick) and messages:

/set weechat.look.prefix_suffix "│"

Full line for read marker:

/set weechat.look.read_marker_string "─"

Arrows for join/quit (be careful, impact on log files):

/set weechat.look.prefix_join "▬▬▶"
/set weechat.look.prefix_quit "◀▬▬"

String for bar item "buffer_filter" (WeeChat >= 0.3.6):

/set weechat.look.item_buffer_filter "•"

"More" indicators in bars (WeeChat >= 0.3.6):

/set weechat.look.bar_more_down "▼"
/set weechat.look.bar_more_left "◀"
/set weechat.look.bar_more_right "▶"
/set weechat.look.bar_more_up "▲"

Colors (for WeeChat >= 0.3.5 with a terminal supporting 256 colors)

Time with gray shading, and no colon separator (WeeChat >= 0.3.5):

/set weechat.look.buffer_time_format "${252}%H${245}%M${240}%S"

Note: updated in WeeChat 0.4.2, the syntax is now:

/set weechat.look.buffer_time_format "${color:252}%H${color:245}%M${color:240}%S"

Another "blue" for background of title and status bars:

/set weechat.bar.title.color_bg 60
/set weechat.bar.status.color_bg 60

Some dark colors for delimiters, host,...:

/set weechat.color.chat_delimiters 29
/set weechat.color.chat_host 24
/set weechat.color.chat_prefix_suffix 24
/set weechat.color.nicklist_away 244
/set weechat.color.separator 60
/set irc.color.reason_quit  244
/set irc.color.topic_new  36
/set irc.color.topic_old 244

More nick colors: add for example "31,35,38,40,49,63,70,80,92,99,112,126,130,138,142,148,160,162,167,169,174,176,178,184,186,210,212,215,247" to nick colors:

/set weechat.color.chat_nick_colors "cyan,magenta,green,brown,lightblue,default,lightcyan,lightmagenta,lightgreen,blue,31,...,247"

(warning: replace "..." by full list of colors above)

Saturday, August 20 2011

Game Flood'it

A new script floodit.py is now available! You can now play to Flood'it inside WeeChat, with following features:

  • single mode
  • versus mode (play vs computer)
  • demo mode
  • 3 different board sizes.

If you are using weeget, just do: /weeget install floodit.py

For help: /help floodit.

Note: mouse is supported with latest devel version of WeeChat (0.3.6-dev).

Screenshot (click for full size):



Saturday, August 6 2011

New features for layout

The layout has improved, here is the list of new features and a bug fixed:

  • merged buffers are now supported in layout: WeeChat will auto merge buffers when they are opened and on /layout apply
  • the layout for windows and buffers is automatically restored after /upgrade (not the layout saved, but the layout you had immediately before doing /upgrade)
  • an old bug was causing bad order of buffers when connecting to many servers at same time, and then /layout apply was required after starting WeeChat


Tuesday, July 26 2011

Mouse support and free movement of cursor

Mouse support has been added to WeeChat, and a "cursor" mode: a mode when you can move cursor everywhere and do actions with keys on focused area.

New commands added:


Before using mouse, add missing keys:

/key missing

Mouse events (clicks on buttons, gestures) are caught as special "keys", in context "mouse". For a list of default events, you can look at documentation (default keys) or output of this command in WeeChat:

/key list mouse

Mouse is not enabled by default. To enable it (at startup and now), do:

/set weechat.look.mouse on
/mouse enable

When mouse is enabled, you can use shift+selection or shift+buttons to select/paste text (like when mouse is disabled). Note that on some terminals like iTerm, you may have to use alt instead of shift.
New key alt+m will toggle mouse on/off.

Finally, thanks to Nei for his scripts, the mouse support in WeeChat is partially based on them.

Mouse support will be improved in near future, for example interactions with words/messages in chat area (select text, click on URLs, ..).
Stay tuned!

Wednesday, June 15 2011

Highlight with regex in specific buffers

A local variable "highlight_regex" has been added in buffers.

It is recommended to use script buffer_autoset.py to set it, so that it's saved and set at any time when buffer is created.

However, it's still possible to set it manually (for testing) with command: /buffer set highlight_regex XXX.

For example, to highlight all messages on server freenode, channel #test:

/autosetbuffer add irc.freenode.#test highlight_regex .*

Monday, May 16 2011

Script cmd_help.py

A new script cmd_help.py is now available. It displays contextual help on command line like:

  • commands:
    • list of commands if you type a non-complete command name, for example: /serv
    • help about command arguments if you type command (and optionally arguments), for example with /server add you'll see arguments for adding an IRC server
  • options:
    • list of options if you type a non-complete option name with command /set, for example: /set weechat
    • help about option if you type a complete or unique option name with command /set, for example: /set weechat.look.command_chars

Note: this script requires version 0.3.5 of WeeChat.

Screenshot (click for full size):


Sunday, May 15 2011

Version 0.3.5

Version 0.3.5 is available!

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

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

New major features in this release:

  • 256 colors support improved (dynamic allocation of colors) (see this post)
  • attributes for colors (bold/reverse/underline) (see this post)
  • better scroll of input (with long text)
  • output of /help improved for list of commands and their arguments (see this post)
  • remember scroll position of buffers in windows
  • list of buffers in filters (see this post)
  • count of messages in hotlist buffers (see this post)
  • swap buffers of windows
  • balance of windows
  • new API function to set help on plugin/script options
  • speller options in aspell plugin (see this post)
  • option for SSL priorities in IRC servers
  • color nicks in nicklist and output of /names

New options:

  • weechat.look.hotlist_add_buffer_if_away
  • weechat.look.hotlist_buffer_separator
  • weechat.look.hotlist_count_max
  • weechat.look.hotlist_count_min_msg
  • weechat.color.status_count_msg
  • weechat.color.status_count_private
  • weechat.color.status_count_highlight
  • weechat.color.status_count_other
  • weechat.look.highlight_tags
  • weechat.look.read_marker_string
  • weechat.look.input_cursor_scroll
  • weechat.look.color_pairs_auto_reset
  • irc.color.topic_old
  • irc.color.topic_new
  • irc.color.nick_prefixes
  • irc.look.buffer_switch_autojoin
  • irc.look.buffer_switch_join
  • irc.look.smart_filter_nick
  • irc.look.color_nicks_in_nicklist
  • irc.look.color_nicks_in_names

New keys:

  • alt + "w", alt + "b": balance the sizes of all windows (/window balance)
  • alt + "w", alt + "s": swap buffers of two windows (/window swap)

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

Friday, April 15 2011

Options for aspell spellers

An "option" section has been added to aspell.conf file, to set options for aspell speller.

A commonly used option is "ignore-case" to ignore case in speller. To enable it, just do:

/set aspell.option.ignore-case "true"

For a list of aspell options, do in your shell:

aspell config

Monday, April 11 2011

Count of messages in hotlist

Count of messages (by priority) has been added to hotlist.

New options:

  • /set weechat.look.hotlist_buffer_separator (default: ", ")
  • /set weechat.look.hotlist_count_max (default: 2)
  • /set weechat.look.hotlist_count_min_msg (default: 2)
  • /set weechat.color.status_count_msg (default: "brown")
  • /set weechat.color.status_count_private (default: "green")
  • /set weechat.color.status_count_highlight (default: "magenta")
  • /set weechat.color.status_count_other (default: "default")

Example with default config:

Count of messages in hotlist

(2 highlights and 5 messages on #test, 1 highlight and 1 private message from FlashCode)

Wednesday, March 9 2011

List of buffers in filters

It is now possible to use a list of buffers in filters. Exclusion of buffers is allowed using prefix "!".

Example: add IRC smart filter on all freenode channels, but not channels beginning with "#private":

/filter add irc_smart irc.freenode.*,!*#private* irc_smart_filter *

Thursday, February 17 2011

Attributes for colors

Attributes have been added for color options. List of supported attributes:

  • "*": bold
  • "!": reverse
  • "_": underline

Attributes are optional and can be added before color name/number/alias.

For self nick as white underlined:

/set weechat.color.chat_nick_self _white

For time in status bar as orange underlined with bold:

/set weechat.color.status_time *_214

Wednesday, February 9 2011

Help of commands improved

The list of commands in /help commands has been improved.

By default it's now a short list (only names of commands), and long list is possible with option -listfull. Moreover, it is possible to list commands for one plugin (or core) only.

Example of short list for irc plugin: /help -list irc

  admin      deop       join       mode       part       samode     stats      voice
  allchan    devoice    kick       motd       ping       sanick     summon     wallchops
  allserv    die        kickban    msg        pong       sapart     time       wallops
  ban        disconnect kill       names      query      saquit     topic      who
  connect    halfop     links      nick       quote      server     trace      whois
  ctcp       ignore     list       notice     reconnect  service    unban      whowas
  cycle      info       lusers     notify     rehash     servlist   userhost
  dcc        invite     map        op         restart    squery     users
  dehalfop   ison       me         oper       sajoin     squit      version

Example of long list for core commands: /help -listfull irc

  admin - find information about the administrator of the server
  allchan - execute a command on all channels of all connected servers
  allserv - execute a command on all connected servers
  ban - ban nicks or hosts
  connect - connect to IRC server(s)
  ctcp - send a CTCP message (Client-To-Client Protocol)
  cycle - leave and rejoin a channel
  dcc - start a DCC (file transfer or direct chat)
  dehalfop - remove channel half-operator status from nick(s)
  deop - remove channel operator status from nick(s)
  devoice - remove voice from nick(s)

Moreover, display of command arguments in /help <command> has been improved.

Old version: /help server

[irc]  /server  [list [servername]] | [listfull [servername]] | [add servername hostname[/port] [-temp] ...

New version: /help server

[irc]  /server  list|listfull [<server>]
                add <server> <hostname>[/<port>] [-temp] [-<option>[=<value>]] [-no<option>]
                copy|rename <server> <new_name>
                del|keep <server>

Thursday, February 3 2011

Dynamic color pairs

WeeChat now creates color pairs dynamically: when a color (foreground + background) is used on screen, a pair is created if it does not yet exist in pairs table.

Therefore, it's not needed any more to use /color add to add colors to use them in options. It is possible to use any terminal color by number in options. However, you can still create an alias on number with command /color alias.

Sunday, January 16 2011

Version 0.3.4

Version 0.3.4 is available!

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

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

New major features in this release:

  • 256 colors support, with unlimited number of nick colors (see this post)
  • irc proxy (relay plugin)
  • redirection of IRC commands (see this post)
  • new irc command /notify
  • rmodifier plugin (see this post)
  • regular expressions for highlights
  • color support for timestamp in chat buffer (see this post)
  • irc option to force color for some nicks
  • share input line between buffers

New options:

  • weechat.color.chat_nick_colors
  • weechat.look.highlight_regex
  • weechat.look.hotlist_unique_numbers
  • weechat.look.input_share
  • weechat.look.input_share_overwrite
  • weechat.look.prefix_align_min
  • irc.look.notify_tags_ison
  • irc.look.notify_tags_whois
  • irc.network.notify_check_ison
  • irc.network.notify_check_whois
  • option "notify" in irc servers
  • irc.look.nick_color_force
  • irc.look.item_away_message
  • irc.color.nick_prefix
  • irc.color.nick_suffix

Sunday, January 9 2011

256 colors

WeeChat now supports 256 colors!

Using new command /color you can browse WeeChat and terminal colors, and define custom pairs. See documentation for more information.

Screenshot (click for full size):

256 colors

Tuesday, December 7 2010

Colored time for messages

It is now possible to add color in time displayed for each line in formated buffers.

Option weechat.look.buffer_time_format now supports colors with format: "${xxx}" where "xxx" is a color name (lightblue, red, ...) or a number (for example: "214" for orange).

Note: updated in 0.4.2, the syntax is now: "${color:xxx}".

Screenshot of colored time, with french flag colors:

French time

Thursday, December 2 2010

Max hotlist level for some nicks

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

Monday, November 8 2010

Redirection of IRC commands

It is now possible to redirect IRC commands to a callback, in plugins/scripts.

First you have to add a hsignal with callback, to receive command output. Then, add redirection by sending a hsignal, and send your command to IRC server. It will automatically use your redirection.

Each redirection uses a pattern, which defines start/stop/extra commands. Default patterns are: ison, list, mode_channel, mode_channel_ban, mode_channel_ban_exception, mode_channel_invite, mode_user, names, ping, time, topic, userhost, who, whois, whowas.

You can create your own pattern with signal "irc_redirect_pattern".

Examples of redirection and pattern creation are available in WeeChat devel doc.

Monday, October 11 2010

Disable highlights from some nicks

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_highlight_nicks" 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 no_highlight_nicks_add joe,mike

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

Wednesday, October 6 2010

New plugin rmodifier

A new plugin called "rmodifier" (for "Regex modifier") has been added.

It's designed to change some strings using regex, for example to hide passwords in commands (input displayed on screen) or in history. By default, password in following commands are hidden by this plugin:

  • /msg nickserv identify ****** (input and history)
  • /msg nickserv ghost ****** (input and history)
  • /oper nick ****** (input and history)
  • /set file.section.password ****** (history only)

Of course you can add your own regex, just look at /help rmodifier.

Saturday, August 7 2010

Version 0.3.3

Version 0.3.3 is available!

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

Important: please read 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

Wednesday, August 4 2010

Script jabber.py

A new script jabber.py is now available. You can connect to jabber servers and chat with buddies.

Quick start:

  • add server: /jabber add jabberfr myname@jabber.fr mypassword
  • connect: /jabber connect jabberfr
  • chat: /jchat nick

Commands provided by script:

  • /jabber
  • /jchat
  • /jmsg

Configuration file is jabber.conf.

Currently, MUCs are not supported, and you can't manage your account, like create/update account, add/remove buddies in roster (nicklist).

Enjoy Jabber!

Monday, July 26 2010

Script cron.py

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)

Sunday, April 18 2010

Version 0.3.2

Version 0.3.2 is available!

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

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

Monday, March 22 2010

Custom completion for aliases

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


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

Friday, February 19 2010

SASL authentication with IRC server

It is now possible to use SASL authentication with IRC server, using two mechanisms: "plain" (default) or "dh-blowfish" (crypted password).

New options have been added to servers:

  • sasl_mechanism: mechanism to use ("plain" or "dh-blowfish")
  • sasl_timeout: timeout (in seconds) for authentication
  • sasl_username: username
  • sasl_password: password

You just have to setup username (your nick) and password (password of nick) and then connect to server, you'll be identified with SASL if all is ok.

If you want to set "dh-blowfish" by default for all servers:

/set irc.server_default.sasl_mechanism dh-blowfish

Monday, February 1 2010

Date in log filenames

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:

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

Sunday, January 31 2010


Version is available!

This version fixes crashes with SSL connection and purge of old DCC chats. It is recommended to upgrade from 0.3.1 to for all users.

Saturday, January 23 2010

Version 0.3.1

Version 0.3.1 is available!

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

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

Sunday, January 17 2010

New IRC output queue with high priority

A new IRC output queue has been added in irc plugin, with high priority. There are now two queues for messages sent to IRC server:

  • queue for user messages or commands, with high priority
  • queue for other messages, with low priority.

Low priority queue is used to send automatic messages, like replies to CTCP messages. So if you are spamed with CTCP messages, WeeChat will first send your messages (queue with high priority), and then CTCP replies (queue with low priority).

Accordingly, anti-flood option has been split into two options:

  • irc.network.anti_flood_prio_high: delay between two user messages/commands
  • irc.network.anti_flood_prio_low: delay between two other messages

Friday, January 8 2010

New IRC commands allchan and allserv

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.

Friday, January 1 2010

Target buffer for IRC messages

New options have been added to choose target buffer for IRC messages.

More info and examples in documentation: http://weechat.org/files/doc/devel/weechat_user.en.html#irc_target_buffer

Monday, December 7 2009

SSL certificates

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 http://www.oftc.net/oftc/NickServ/CertFP.

Thursday, October 15 2009

Script translate.py

A new script translate.py is now available. It can translate words with a command or in input (whole input or last word).

Base and target languages can be customized and given as argument of command, or at beginning of input if you're using a key calling command.

Example of keys you can bind to use script:

  • translate input with alt-t + alt-t (using default from_to): /key bind meta-tmeta-t /translate
  • translate input with alt-t + alt-r (reverse of from_to): /key bind meta-tmeta-r /translate !
  • translate last word in input with alt-t + alt-w (using default from_to): /key bind meta-tmeta-w /translate +
  • restore input as it was before last translation with alt-t + alt-u: /key bind meta-tmeta-u /translate <

Other examples:

  • reverse languages (english to french by default): /translate ! this is a test
  • english to italian: /translate en_it I want this string in italian

Recommended alias:

/alias tr /translate

You can get more help with /help translate.

Monday, October 5 2009

Script hlpvitem.py

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: WeeChat hlpvitem

You can setup some options with /set:

  • /set plugins.var.python.hlpvitem.show_all_buffers on/off (default: off)
  • /set plugins.var.python.hlpvitem.buffer_number on/off (default: on)
  • /set plugins.var.python.hlpvitem.buffer_short_name 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.color_string_highlight color (default: empty)
  • /set plugins.var.python.hlpvitem.color_string_private color (default: empty)
  • /set plugins.var.python.hlpvitem.color_buffer_number color (default: empty)
  • /set plugins.var.python.hlpvitem.color_buffer_name 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)

Tuesday, September 15 2009

IRC CTCP replies

It is now possible to customize CTCP replies, or block some CTCP queries (do not reply).

For example, to customize reply to CTCP "VERSION", use following command:

/set irc.ctcp.version "I'm running WeeChat $version, it rocks!"

If you want to block CTCP "VERSION" (do not reply to a query), then set empty string:

/set irc.ctcp.version ""

Even unknown CTCP can be customized, for example you can reply to CTCP "BLABLA":

/set irc.ctcp.blabla "This is my answer to CTCP BLABLA"

It is possible to customize CTCP for one server only, using its internal name before CTCP name:

/set irc.ctcp.freenode.version "WeeChat $version (for freenode)"

If you want to restore standard CTCP reply, then remove option:

/unset irc.ctcp.version

Some codes are automatically expanded by WeeChat when replying to CTCP, please read documentation for more information (User's guide, chapter: Plugins / IRC plugin / CTCP replies).

Sunday, September 6 2009

Version 0.3.0

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!

Wednesday, June 10 2009

Merge of buffers

It is now possible to merge buffers with command /buffer merge (or unmerge). IRC plugin uses that feature to merge server buffers, with the new option irc.look.server_buffer (merge_with_core, merge_without_core, independent).

When a buffer is merged to one or more other buffers, they will have same number, and chat area will display mixed lines (short name of buffer is displayed on each line, to know to which buffer line belongs). Bars still display content for current selected buffer.

New key ctrl-x has been added to swtich current active buffer when many buffers are merged (old key alt-s has been removed).

For devel users: it's not possible to upgrade from previous versions to this one, and you should do /key missing to add missing key.

Saturday, May 2 2009

Data for callbacks in script API

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):


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

Friday, April 24 2009

Easy switch between two buffers

A new feature has been added recently to easily switch to another buffer, then come back to current one.
For example if you are on buffer #2, you press alt-1 twice: you'll come back to buffer #2.

This new feature can be disabled, if you think old behaviour was better (really?):
/set weechat.look.jump_current_to_previous_buffer off

Saturday, April 11 2009

Completion improved for command arguments

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!

Tuesday, April 7 2009

Script weeget.py, a script manager!

A new script weeget.py is now available. It is a scripts manager: you can install, remove, upgrade your scripts using command /weeget.

Following actions are available :

  • update local cache (list of scripts, which automatically expires after one hour by default),
  • show detailed info about scripts,
  • install scripts,
  • remove scripts,
  • upgrade all obsolete scripts,
  • check status of local scripts.

Weeget uses its own configuration file, called wg.conf.

You can setup some options with /set:

  • /set wg.color.installed color (default: yellow)
  • /set wg.color.language color (default: lightblue)
  • /set wg.color.obsolete color (default: lightmagenta)
  • /set wg.color.running color (default: lightgreen)
  • /set wg.color.script color (default: cyan)
  • /set wg.color.unknown color (default: lightred)
  • /set wg.scripts.cache_expire time (default: 60)
  • /set wg.scripts.dir directory (default: %h/weeget)
  • /set wg.scripts.url url (default: http://www.weechat.org/files/plugins.xml.gz)

Update on 2012-09-29: since version 0.3.9, weeget.py has been replaced by a C plugin called "script" (command /script), see Scripts manager.

Screenshot: WeeChat weeget

Sunday, March 8 2009

Script vdm.py

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.number_as_prefix 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: WeeChat vdm

Friday, March 6 2009

New hook "process"

New hook type "process" has been added to WeeChat. You can use it in C plugins, and all scripts languages (perl, python, ruby, lua and tcl).

It runs a command with fork, and send you result (return code, stdout and stderr) via a callback, when command has ended, or if WeeChat output buffer is full (then it will be partial result of command). There is optional timeout (in milliseconds), to kill process if it's still running after given time.

The script shell.py has been updated to use that new hook.

Sunday, February 8 2009

Script go.py

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: WeeChat go

Sunday, January 4 2009

New version of script iset.pl

Script iset.pl has been improved. Now you can setup colors for option names, types and values. And null values are displayed with different color (for IRC server options). There's new config options, you can set with /set command:

  • /set plugins.var.perl.iset.color_bg_selected color
  • /set plugins.var.perl.iset.color_option color
  • /set plugins.var.perl.iset.color_option_selected color
  • /set plugins.var.perl.iset.color_type color
  • /set plugins.var.perl.iset.color_type_selected color
  • /set plugins.var.perl.iset.color_value color
  • /set plugins.var.perl.iset.color_value_selected color
  • /set plugins.var.perl.iset.color_value_undef color
  • /set plugins.var.perl.iset.color_value_undef_selected color

A screenshot is better than long speech: weechat_iset_2009-01-04.png

Wednesday, December 17 2008

New bar filling options

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:


Wednesday, November 26 2008

New plugin DC

A new plugin has been added: DC. It is used to transfer files using DC file-sharing protocol.

It's available as a separate plugin, and must be compiled and installed with WeeChat development version.
Documentation and screenshots are available on this wiki page: http://wiki.flashtux.org/wiki/WeeChat/dc

Sunday, November 23 2008

Support for many proxies

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"

Thursday, November 13 2008

Script mastermind.pl

A new script mastermind.pl is now available!

Screenshot: Mastermind

Keys are displayed on buffer displayed by /mastermind, enjoy!

Friday, October 31 2008

New logger features

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:

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

Sunday, October 26 2008

Git branch protocols merged to master

Git branch "protocols" has been merged to "master".

If you're using protocols branch, you should switch back to master branch now, using following commands:
git checkout master
git pull
git remote prune origin

Saturday, October 25 2008

Smart IRC join/part/quit message filter

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

Saturday, October 18 2008

Aspell plugin is born again

New aspell plugin is available!

Plugin as now its own configuration file, called aspell.conf. Options can be set with /set command. List of options with default value:

  • aspell.look.color = lightred
  • aspell.check.commands = "ame,amsg,away,command,cycle,kick,kickban,me,msg,notice,part,query,quit,topic"
  • aspell.check.default_dict = ""
  • aspell.check.word_min_length = 2

You can enable aspell for all buffers with default dictionary (or list of dictionaries), with command: /set aspell.check.default_dict "en,fr"

To enable a specific language on a buffer, use: /aspell enable fr
If you speak both english and german (often english, less german), use: /aspell enable en,de

- page 1 of 2