The terminal title script for Weechat displays user-defined information in the terminal title if supported by the terminal.


The latest version of the Weechat terminal title script is available from its source code repository. The script itself can also be downloaded directly.

Source Code Repository

The current development version is available from the source code repository.



The terminal title script is written in Python 2 and requires Weechat 0.3.3 or later with support for Python scripts.

The terminal title script can be configured through the following Weechat settings:

The string displayed in the terminal title. The string may contain certain substitution identifiers in order to insert information from Weechat at runtime.

Substitution identifiers always start with a "%" sign, two adjacent "%" act as an escape and are substituted with a literal "%". Substitution identifiers which are followed by alphanumeric characters or an underline character must be sourrounded by braces, e.g. "%{buffer_title}_foo". The following substitution identifiers can be referenced from plugins.var.python.terminal-title.title:

The title of the current buffer.
The name of the current buffer.
The plugin name of the current buffer.
The number of the current buffer.
The number of nicks and groups in the nicklist.
The number of buffers.
The buffers in the hostlist.
The Weechat version.


Please send any feedback, translations or bug reports via email to

Bug Reports

When sending bug reports, please always mention the exact version of the script with which the issue occurs as well as the version of Weechat and the operating system you are using and make sure that you provide sufficient information to reproduce the issue and include any input, output, any error messages and Python stack traces.


Except otherwise noted, all files are Copyright (C) 2010 Guido Berhoerster and distributed under the following license terms:

Copyright (C) 2010 Guido Berhoerster

Licensed under the GNU General Public License Version 3

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see