Setting up Weechat

September 26, 2016

Table Of Contents

I like to run weechat in tmux on a VPS and then ssh into it and pick up where I left off. I also use bitlbee to connect to XMPP servers. Weechat has lots of options and these are some notes for setting up. Mostly taken from a variety of sources online when you search for weechat setup.


WeeChat quick start is good to get going for freenode.

/save at the end

Weechat configuration

Set detault nick for all servers:

/set irc.server_default.nicks alexjj

Allow for multi-line input:

/set 0
/set 3

Hide join/leave messages in IRC (After enabling freenode)

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

Making it look a bit nicer:

/set weechat.look.prefix_same_nick "⤷"
/set weechat.look.prefix_error "⚠"
/set weechat.look.prefix_action "⚡"
/set weechat.look.bar_more_down "▼▼"
/set weechat.look.bar_more_left "◀◀"
/set weechat.look.bar_more_right "▶▶"
/set weechat.look.bar_more_up "▲▲"
/set weechat.look.prefix_suffix "╡"
/set weechat.color.chat_nick_colors red,green,brown,blue,magenta,cyan,white,lightred,lightgreen,yellow,lightblue,lightmagenta,lightcyan
/set weechat.color.separator 31
/set buffers.color.current_fg 31
/set buffers.color.current_bg white
/set buffers.color.hotlist_message_fg 229
/set buffers.color.hotlist_private_fg 121
/set buffers.color.hotlist_highlight_fg 163
/set buffers.color.number 239
/set buffers.color.number_char 245
/set "${inactive}"
/set black
/set 31         #Or white if 31 does nothing

Away checks and limits

/set irc.server_default.away_check 10
/set irc.server_default.away_check_max_nicks 25

Toggle nicklist with esc n

/key bind meta-n /bar toggle nicklist

Adjust title, status, and input bars

This creates new root bars to replace the per window ones. So there's not repetition when you break up the window for highlight mon.

Create and customise activetitle bar

/bar add activetitle window top 1 0 buffer_title
/set 500
/set "${active}"
/set white
/set 31
/set on

Customize the title bar

/set "${inactive}"
/set black
/set 31

Create and customise the rootstatus bar

/bar add rootstatus root bottom 1 0 [time],[buffer_count],[buffer_plugin],buffer_number+:+buffer_name+(buffer_modes)+{buffer_nicklist_count}+buffer_filter,[bitlbee_typing_notice],[lag],[aspell_dict],[aspell_suggest],[hotlist],completion,scroll
/set 31
/set 234
/set on
/set 500
/bar del status
/bar set rootstatus name status

Create and customise the rootinput bar

/bar add rootinput root bottom 1 0 [buffer_name]+[input_prompt]+(away),[input_search],[input_paste],input_text,[spell_correction]
/set black
/set 1000
/bar del input
/bar set rootinput name input

Customise the nicklist bar

/set 229
/set on
/set "${nicklist} && ${window.number} == 1"
/set 14
/set 14


Install script manager:

/script install

Scripts I like:

To skip to the answer:

/script install

Configuring Scripts

Edit buffer bar:

/set irc.look.server_buffer independent
/set top
/set buffers.color.number white
/set buffers.look.hotlist_counter on
/set buffers.name_size_max 20
/set buffers.color.current_bg default
/set buffers.color.current_fg lightcyan
/set buffers.color.hotlist_message_bg default
/set buffers.color.hotlist_message_fg yellow


/set plugins.var.perl.highmon.alignment "nchannel"
/window splith 15
/buffer highmon

To move back to main window press F7 or F8 but if those don't work (e.g. via GateOne) type /window +1

/key bind meta-g /go

Binds ESC + G to run go. It then displays a row of buffers and you can press 1,2,3... etc to go to them or start typing the channel. Tab completion also included.

Turn on recover op for my channel:

/set plugins.var.perl.recoverop.regex "\A(freenode\.#alexjj)\Z"

screen away

/set plugins


/set weechat.look.save_layout_on_exit all


Setup connection to bitblee:

/server add im localhost/6667 -autoconnect
/connect im

In &bitlbee buffer:

register YOUR_PASS

Back in weechat buffer:

/set "/msg &bitlbee identify YOUR_PASS"

Add account

acc add jabber PASSWORD
acc 0 set
Change any settings
acc 0 on

To see all the accounts and number:

acc list

Add and join group chat

chat add 0
/join #room

Auto join channel

Find all channels

channel list
channel 1 set auto_join true

Or whatever the channel number is.


Things to look into: