Nicolas Jeannerod

Beautify your Weechat

This article aims to make your WeeChat beautifull. It is based on my personal experience, and on a few articles on the topic:

In all this article, I present configuration changes that make – in my opinion – Weechat nicer to use. I suggest that you read things before trying them out. I am myself not using eveyrthing that is listed here, you will probably want to take only what you find interesting.

When playing with Weechat's parameters, I can only advise to use iset's interface. Get it with:

/script install iset

and access it with /iset.

Let's go!


To use the power of the unicode, your locale must be UTF-8, your font must have the right chars and your terminal/s must support it.

Make the bars nicer:

/set weechat.look.prefix_suffix "│"
/set weechat.look.read_marker_string "—"
/set weechat.look.separator_horizontal "—"

Join/part prefixes:

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

The bar item when a channel has a filter enabled:

/set weechat.look.item_buffer_filter "•"

The "more" indicators:

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

Special messages prefixes:

/set weechat.look.prefix_action "•"
/set weechat.look.prefix_error "⚠"
/set weechat.look.prefix_network "ℹ"


To use 256 colors, all your terminal/s must support it.

Darker things are less aggressive…

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

/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


Use colors in the nicklist:

/set irc.look.color_nicks_in_nicklist on

Use the fact that we enabled 256 colors to have more choices:

/set weechat.color.chat_nick_colors "cyan,magenta,green,brown,lightblue,lightcyan,lightmagenta,lightgreen,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"

Or even more choices:

/set weechat.color.chat_nick_colors "1,2,3,5,6,7,8,9,10,11,12,13,14,20,21,22,23,26,27,28,29,30,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,56,57,58,59,62,63,64,65,66,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,92,93,94,95,96,98,99,100,101,102,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140,141,142,143,144,145,146,147,148,149,150,151,152,153,154,155,156,157,158,159,160,161,162,163,164,165,166,167,168,169,170,171,172,173,174,175,176,177,178,179,180,181,182,183,184,185,186,187,188,189,190,191,192,193,194,195,196,197,198,199,200,201,202,203,204,205,206,207,208,209,210,211,212,213,214,215,216,217,218,219,220,221,222,223,224,225,226,227,228,229,230,238,239,240,241,242,243,244,245,246,247,248,249"

Replace the nickname by a small arrow when the previous message is from the same user:

/set weechat.look.prefix_same_nick "↪"

Limit the size of a username (in the prefix column) to 10 characters:

/set weechat.look.prefix_align_max 10


Allow input text zone to expand on up to 3 lines:

/set weechat.bar.input.size 0
/set weechat.bar.input.size_max 3

Weechat can support the mouse:

/set weechat.look.mouse on