Skip to content

Instantly share code, notes, and snippets.

What would you like to do?
My always up-to-date WeeChat configuration (weechat-dev)

WeeChat Screenshot

You need at least WeeChat 2.5 for everything to work

Enable mouse

/mouse enable

Encrypted password in sec.conf

/secure passphrase <pass>
/secure set freenodepass <pass>
/secure set snoonetpass <pass>
/secure set undernet_userpass <user> <pass>
/secure set undernet_secret <TOTP secret>
/secure set relaypass <pass>
/secure set mariechannel <buffer fullname of my friend's channel>


Default settings

/set irc.server_default.sasl_mechanism PLAIN
/set irc.server_default.sasl_username r3m
/set irc.server_default.nicks r3m
/set irc.server_default.capabilities "account-notify,away-notify,cap-notify,multi-prefix,server-time,"

the last line request some IRCv3 capabilities. Capabilities supported by WeeChat are: account-notify, away-notify, cap-notify, extended-join, multi-prefix, server-time, userhost-in-names. See IRCv3 Specifications to learn more about IRCv3 capabilities.

Network-specific settings

/server add freenode -ssl -autoconnect
/set irc.server.freenode.sasl_password ${}

/server add oftc -ssl -autoconnect
/set irc.server.oftc.ssl_cert "%h/ssl/nick.pem"
/set irc.server.oftc.command_delay 5

/server add snoonet -ssl -autoconnect
/set irc.server.snoonet.sasl_password ${}

/server add undernet
/set irc.server.undernet.command "/eval /msg login ${} ${info:totp_generate,${}};/quote silence *!*@*,~*!*@*"  

/connect -all

The command option for the undernet network automatically identify myself to X once connected and it is using 2FA. WeeChat 2.4 have a TOTP generator. The silence command will ignore everyone excepts those identified to X (even if the umode x is not set).


Load at startup

/set weechat.plugin.autoload "*,!guile,!javascript,!lua,!php,!tcl,!fifo,!xfer"

this will load all modules except guile, javascript, lua, php, tcl, fifo and xfer


/set spell.check.default_dict en,fr
/set spell.check.suggestions 3
/set spell.color.suggestion *green
/spell enable

Set the dictionary order to fr,en for french channels and all undernet network related buffer

/trigger add setdict signal irc_channel_opened;irc_pv_opened;irc_server_opened
/trigger set setdict conditions "(${buffer[${tg_signal_data}].full_name} =* irc.undernet.* || (${buffer[${tg_signal_data}].full_name} =* *fr && ${buffer[${tg_signal_data}].local_variables.type} == channel)) && ${info:spell_dict,${buffer[${tg_signal_data}].full_name}} !* fr,*"
/trigger set setdict command "/command -buffer ${buffer[${tg_signal_data}].full_name} * /mute /spell setdict fr,en"

Note: we will add the suggestions to the status bar later.


/relay sslcertkey
/relay add ssl.irc <port>
/relay add ssl.weechat <port>
/set ${}

If you want a trusted certificate, use let's encrypt! with weechat relay.


/set logger.level.irc 4
/set logger.mask.irc %Y/$server/$channel.%m-%d.log


/script install

/eval /set autosort.sorting.signals ${autosort.sorting.signals} buffer_localvar_added buffer_localvar_changed
/autosort helpers set french_channels_first ${if:${type}==channel&&${}!~fr$&&${info:spell_dict,${buffer.full_name}}!~^fr}
/autosort rules insert 6 ${french_channels_first}

this rule will show french channels first (those that the name end with fr and also those that spell is set to fr)

/buffer_autoset add core.weechat notify 3
/buffer_autoset add irc.server.* notify 3


/buffer_autoset add exec.exec.conky short_name conky

exec conky at startup and right now

/set weechat.notify.exec.exec.conky none
/set weechat.startup.command_after_plugins "/exec -norc -noln -buffer conky conky"
/exec -norc -noln -buffer conky conky

change the title of the conky buffer

/buffer_autoset add exec.exec.conky title Conky - the light-weight system monitor

Change the title Executed commands to Conky - the light-weight system monitor

beautify the output

/trigger add conky_tag_color modifier weechat_print
/trigger set conky_tag_color conditions "${tg_buffer} == exec.exec.conky && ${tg_tags} =~ ,exec_stdout, && ${tg_message_nocolor} =~ ^[^:]+: *[^ ]"
/trigger set conky_tag_color regex "/^ \t([^:]+):(.*)/ ${color:_31}${re:1}\t${color:reset}${re:2}/ /.*/${tg_message_nocolor}/field /.*/${tg_message_nocolor}/value / /_/field /^([^:]+):.*/${re:1}/field /^[^:]+: *(.*)/${re:1}/value / +$//value /.*Load Average\t.*//"
/trigger set conky_tag_color command "${if:${field}==Load_Average?/buffer set localvar_set_conky_${field} ${value}:/mute set plugins.var.python.text_item.conky_${field} all \${if:${buffer.num_displayed}==?${field} ${color:white}${value}${esc:\x7D}}"

this trigger will beautify the output of conky, add a localvar with the load average (to use in buflist) and add a option for every lines. These options are actually text_item options so we can use them in a bar. We will add the items later in the item option of the status bar. These items will be shown only if the conky buffer is not visible in any windows. Don't change .conkyrc because this trigger is tied to this particular .conkyrc (change the trigger if you change .conkyrc)

my .conkyrc

background no
cpu_avg_samples 2
net_avg_samples 2
no_buffers yes
out_to_stderr no
update_interval 1.0
uppercase no
use_spacer none

Load Average: ${loadavg 1 2}
Uptime: $uptime
CPU: $cpu%
RAM: $memperc%
Swap: $swapperc%
Up: ${upspeed venet0}
Down: ${downspeed venet0}

Note: you need conky-cli package on Debian

Weather with

/buffer_autoset add short_name weather
/set fr
/trigger add weather command weather
/trigger set weather regex "/\s/_/tg_argv_eol1"
/trigger set weather command "/exec -noflush -norc -noln -buffer weather curl -s${tg_argv_eol1}?lang=${}"

I found something very similar on the alias wiki page of WeeChat on GitHub. I adjust it for my own use. So when you type /weather Montreal, a new buffer will be created and will show the output of curl -s (I created a trigger instead of an alias to replace space by _ in city name)

/trigger add set_title_weather_buffer print ""
/trigger set set_title_weather_buffer conditions "${tg_message_nocolor} !~ ^\W && ${tg_message_nocolor} !~ (wttr\.in|@igor_chubin)"
/trigger set set_title_weather_buffer regex "/.*/${tg_message_nocolor}/ /[^:]+:(.*)/${re:1}/tg_message"
/trigger set set_title_weather_buffer command "/buffer set title ${tg_message_nocolor};/buffer set localvar_set_weather ${tg_message}"

I created this trigger to change the title of the buffer from Executed commands to Weather for City: Montreal, Canada.

/trigger add weather_shortcut modifier input_text_for_buffer
/trigger set weather_shortcut conditions "${buffer[tg_modifier_data].full_name} == && ${tg_string_nocolor} !~ ^/"
/trigger set weather_shortcut regex "==(.*)==/weather ${re:1}"

This trigger will allow you to enter only the city name (without /weather) in the weather buffer.


Bar buflist and buflist_hotlist (require the escape and inc_utils triggers)

unmerge servers buffers from core and indent

/set irc.look.server_buffer independent

Note: show channels and privates buffers under their respective server instead of mixing them all.

/bar set buflist separator off
/bar set buflist priority 2
/bar set buflist size 15
/bar set buflist items buflist
/bar add buflist_hotlist root left 1 1 buflist2
/bar set buflist_hotlist priority 1
/bar set buflist_hotlist size 3

/set buflist.format.hotlist_highlight "${color:163}"
/set buflist.format.hotlist_message "${color:229}"
/set buflist.format.hotlist_private "${color:121}"

/set buflist.format.buffer "${if:${}==buflist?${eval:${format_name}}:${if:${}==buflist2?${if:${type}==server?${color:31,31}} ${eval:${format_hotlist}}}}"
/set buflist.format.buffer_current "${if:${}==buflist?${eval:${format_name}}:${if:${type}==server?${color:31,31}} }"
/set buflist.format.number "${if:${current_buffer}?${if:${type}==server?${color:*white,31}:${color:*white}}${hide:>,${buffer[last_gui_buffer].number}} :${if:${type}==server?${color:black,31}:${color:239}}${number}${if:${number_displayed}?.: }}"
/set buflist.format.indent "${if:${type}==channel&&${}=~fr$||${info:spell_dict,${buffer.full_name}}=~^fr?${color:blue}f :  }${color:*white}"
/set "${cutscr:${info:inc,-1,${}},${if:${type}==server?${color:white}:${color:${weechat.color.chat_prefix_more}}}${weechat.look.prefix_align_more},${if:${type}=~^(channel|private)$?${eval:${format_number}${indent}}${eval:${color_hotlist}}${name}:${if:${type}==server?${if:${info:irc_server_isupport_value,${name},NETWORK}?${eval:${format_number}${indent}}${color:white,31}${info:irc_server_isupport_value,${name},NETWORK}:${eval:${format_number}${indent}}${color:white,31}${name}}:${eval:${format_number}${indent}}${eval:${color_hotlist}}${name} ${color:31}${buffer.local_variables.filter}${buffer.local_variables.conky_Load_Average}${}}}}"
/set buflist.format.hotlist "${if:${type}==server?${color:,31}}${if:${cutscr:${},, ${hotlist}}==${esc:\x20}${hotlist}?${repeat:${info:ruby_eval,hotlist = '${info:escape,${hotlist}}'; puts ((${} - 1 - Weechat.string_remove_color(hotlist, '').chomp.size).to_s)}, }${hotlist}:${cutscr:${info:ruby_eval,puts ((${} - 2).to_s)},${if:${type}==server?${color:white}:${color:${weechat.color.chat_prefix_more}}}${weechat.look.prefix_align_more},${hotlist}}}"

/set weechat.look.bar_more_down ""
/set weechat.look.bar_more_up ""

/trigger add bar_scroll command_run "/bar scroll buflist*"
/trigger set bar_scroll regex "/.*/${tg_command}/arguments /.* ([^ ]+)$/${re:1}/arguments"
/trigger set bar_scroll command "/bar scroll buflist * ${arguments};/bar scroll buflist_hotlist * ${arguments}"
/trigger set bar_scroll return_code "ok_eat"

/trigger add bar_resize command_run "/bar set buflist size*;/bar set buflist_hotlist size*"
/trigger set bar_resize command "/buflist refresh"

/key bindctxt mouse @bar(buflist*):alt-wheelup /bar set ${_bar_name} size ${info:inc,-1,${${_bar_name}.size}}
/key bindctxt mouse @bar(buflist*):alt-wheeldown /bar set ${_bar_name} size ${info:inc,,${${_bar_name}.size}}

There's a lot going on here. I created a second bar, buflist_hotlist, that contain the item buflist2. This item contain only the hotlist so we can resize this bar individually from the buflist bar. I use a very small amount of scripting, only to substract one from a number and get the length of ${hotlist}. The trigger will synchronise the scroll between the two bars. That is, if you scroll the buflist bar, the buflist_hotlist bar will also be scroll, and vice versa. I bind two keys, alt-wheelup and alt-wheeldown, to resize the bars.

Bar active title

/bar add activetitle window top 1 1 [#window_number],buffer_title
/bar set activetitle priority 500
/bar set activetitle conditions ${active}
/bar set activetitle color_fg white
/bar set activetitle color_bg 31

Note: This bar will be different from the already created one. I set the conditions to ${active} so this bar will be displayed on the active window only. The other one will be used for other windows.

Bar title

/bar set title conditions ${inactive}
/bar set title color_fg black
/bar set title color_bg 31
/bar set title items [#window_number],buffer_title

Bar status

/bar add rootstatus root bottom 1 1 [time],[buffer_count],[buffer_plugin],buffer_number+:+buffer_name+(buffer_modes)+{buffer_nicklist_count}+buffer_filter,[bitlbee_typing_notice],[lag],[spell_dict],[spell_suggest],completion,scroll,conky_CPU,conky_RAM,conky_Swap,conky_Up,conky_Down
/bar set rootstatus color_fg 31
/bar set rootstatus color_bg 234
/bar set rootstatus priority 500
/bar del status
/bar set rootstatus name status

Note: the built-in status bar is of type window. I prefer a status bar of type root which means it will be outside any window. At this time, you can't change the type of a bar. So we delete the status bar and create a new one.

Bar input

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

Note: the built-in input bar is of type window. I prefer a input bar of type root which means it will be outside any window. At this time, you can't change the type of a bar. So we delete the status bar and create a new one.

Bar Nicklist

/bar set nicklist color_fg 229
/bar set nicklist separator 1
/bar set nicklist conditions ${nicklist} && ${window.number} == 1 && ${buffer.full_name} !~ ^irc.freenode.(#newsbin|##news)$
/bar set nicklist size_max 14
/bar set nicklist size 14

Note: I changed the conditions to display the nicklist only on buffer of type channels ${nicklist} and on the window number 1, which is my chat window (2 being my highlight window and 3 my conky window). In my case, I could remove ${window.numer} == 1 because the highmon and exec buffer (conky) are not of type channels so ${nicklist} is enough.

Bar line_number

/bar add line_number root left 5 1 line_number
/bar set line_number hidden on

/trigger add show_bar_cursor_go signal input_text_changed
/trigger set show_bar_cursor_go conditions "${buffer[${tg_signal_data}].input_buffer} == /cursor go${esc:\x20}"
/trigger set show_bar_cursor_go command "/bar show line_number;/wait 10s /bar hide line_number"

/set plugins.var.python.text_item.line_number all|signal_sigwinch ${eval:${info:ruby_eval,puts (0...${info:term_height}).to_a.join('\${\n${esc:\x7D}')}}

This is inspired from the excellent script by GermainZ. A bar with line number will be show whenever you type /cursor go and will dissapears 5 seconds later (you need to put the x coordinates before the y one (line number). example: /cursor go x,<the line number>. Of course, if you use the script, don't add this bar to your config it will be pretty useless.


Layout highlight-or-news

/eval /ruby eval -oc print "/window splith #{(8.0 / ${window[gui_current_window].win_height} * 100).to_i}"
/buffer add -switch highmon
/window 1
/layout store highlight-or-news

Note: Instead of having only one window, we split it to create another one that we will use to show all highlights.

Layout highlight-or-news-and-conky

/window 2
/window splitv 85
/buffer exec.conky
/window 1
/layout store highlight-or-news-and-conky

Note: split the highlight monitor window in 2 and show conky in the new one

Channel Monitor

WeeChat Screenshot

/buffer_autoset add core.chanmon title Channels Monitor

/trigger add chanmon_like print "*;irc_privmsg"
/trigger set chanmon_like conditions "${buffer.local_variables.type} == channel && ${buffer.full_name} != irc.freenode.##news"
/trigger set chanmon_like command "/print -newbuffer chanmon -tags ${tg_tags} ${color:${info:nick_color_name,${server}}}${cut:4,${color:${weechat.color.chat_prefix_more}}${weechat.look.prefix_buffer_align_more},${server}}${color:${info:nick_color_name,${channel}}}${channel}\t${if:${tg_tags} !~ ,irc_action,?${weechat.look.quote_nick_prefix}${tg_prefix}${color:reset}${weechat.look.quote_nick_suffix}:${tg_prefix}${color:reset}} ${tg_message}"

This trigger create a new buffer named chanmon. This buffer will contain all the messages from all the channels you are on. This is almost identical to the scripts but without any options.

Highlight Monitor

/eval /set weechat.startup.command_after_plugins "${weechat.startup.command_after_plugins};/buffer add highmon"

/buffer_autoset add core.highmon title Highlight Monitor

/trigger add highmon_like print "*;irc_privmsg"
/trigger set highmon_like conditions "${tg_highlight} == 1 && ${tg_displayed} == 1 && ${buffer.local_variables.type} == channel"
/trigger set highmon_like command "/print -newbuffer highmon -tags ${tg_tags} ${color:${info:nick_color_name,${server}}}${cut:4,${color:${weechat.color.chat_prefix_more}}${weechat.look.prefix_buffer_align_more},${server}}${color:${info:nick_color_name,${channel}}}${channel}\t${if:${tg_tags} !~ ,irc_action,?${weechat.look.quote_nick_prefix}${tg_prefix}${color:reset}${weechat.look.quote_nick_suffix}:${tg_prefix}${color:reset}} ${tg_message}"

This trigger create a new buffer named highmon. This buffer will contain all the highlighted message from all the channels you are on. This is similar to the script but without any options.


WeeChat Screenshot

/filter add news irc.freenode.##news !nick_newsly*+!host_yano@unaffiliated/yano/bot/rssly,!irc_privmsg *
/filter add news_interest irc.freenode.##news nick_newsly*+irc_privmsg,host_yano@unaffiliated/yano/bot/rssly+irc_privmsg !^(\s|\[)(Reddit [-] /r/netsec|Wired|freenode|EFF Updates|erry's blog|techdirt|TorrentFreak|Science Daily|Hacker News|CNET|phoronix|Ars Technica|The Intercept|france24|Radio-Canada Nouvelles|Canoe|Huffington Post [-] Weird News|Journal du hacker|Futura Sciences)( \-| | |\])

##news is a channel on Freenode with a bot named newsly that display news from various sources. The first /filter command hides everything that happends on the channel except PRIVMSG from newsly. The second /filter hides every news except those from the given list.

The following triggers use the new hook_line. You must be using weechat 2.3. Otherwise, looks in the revisions to take the other version.

/trigger add news_line line *;irc.freenode.##news;irc_privmsg+nick_newsly*
/trigger set news_line regex "/.*/${tg_message_nocolor}/site_name /^\[([^]]+)\].*/${re:1}/site_name /.*/${tg_message_nocolor}/title /^\[[^]]+\]//title /.*/${site_name}/site_color /^([^-]+).*/${info:nick_color_name,${re:1}}/site_color /.*/${title}/url ==.*(https?://[^ ]+).*==${re:1}==url /\+/%00/url /,/%01/url /\!/%02/url /\*/%03/url /.*/${re:0}url_${url}/tags ==https?://[^ ]+ .*====title /.*/[${color:${site_color}}${site_name}${color:reset}] ${title}/message /.*//prefix"

the normal version.

/trigger add news_line line *;irc.freenode.##news;irc_privmsg+nick_newsly*
/trigger set news_line regex "/.*/${tg_message_nocolor}/site_name /^\[([^]]+)\].*/${re:1}/site_name /.*/${tg_message_nocolor}/title /^\[[^]]+\]//title / - / ${color:-underline} /site_name /.*/${site_name}/site_color /^([^]+).*/${info:nick_color_name,${re:1}}/site_color /.*/${title}/url ==.*(https?://[^ ]+).*==${re:1}==url /\+/%00/url /,/%01/url /\!/%02/url /\*/%03/url /.*/${re:0}url_${url}/tags ==https?://[^ ]+ .*====title /.*/${color:_black,${site_color}} ${site_name} ${color:${site_color},default}${color:reset}${title}/message /.*//prefix"

the one with powerline symbols.

These triggers will do a few things. The URL will be removed from the message and inserted, as a tag, in the tags instead. This is very useful because url are often very long. The date will also be removed from the message for similar reason. The difference between the two triggers above are the way they display the site name (refers to the screenshot above).

Note: The url and the date will not appears in log. This is a consequence of using a modifier or a line trigger.

/trigger add hsignal_news_click hsignal news_click
/trigger set hsignal_news_click regex "/.*,url_([^,]+).*/${re:1}/_chat_line_tags /%00/+/_chat_line_tags /%01/,/_chat_line_tags /%02/!/_chat_line_tags /%03/*/_chat_line_tags"
/trigger set hsignal_news_click command "/command -buffer ${buffer.full_name} core /input insert ${if:${_key}==m?${_chat_line_message} }${_chat_line_tags}\x20"

/key bindctxt cursor @chat(irc.freenode.##news):i hsignal:news_click;/cursor stop
/key bindctxt cursor @chat(irc.freenode.##news):m hsignal:news_click;/cursor stop

This trigger will be triggered when we press 'i' or 'm' on a news in cursor mode (in general we invoke this with the middle mouse button). 'i' insert the URL in the input bar. If the URL is too long to view it all, simply press return to send it to the channel, which anyway is +m so nobody will see it, and press alt+l to go in bare mode (so you can click on the URL). 'm' is more interesting, generally when you press 'm' in cursor mode, you add the message in the input bar, but remember, the message does not contain the URL anymore, so it is useless to send the title to someone without the URL. So, in this channel, 'm' is different. The URL is added back to the message.

If you wonder why I replace +,*,! and comma from the url, it is because those have a special meaning in the tag mechanism or in /filter and it will be hard to, for example, filter on a tag containing a comma. I replace them by ASCII control characters in percent-encoding style. At first, I was replacing them by their equivalent percent-encoding style so for example + became %2B. The problem is that we must replace %2B by + when we retrieve the url from the tag later, because a + have a special meaning in url but not %2B (so this will not be the same url). But this will replace any %2B to +, even those that was originally %2B not +. So, instead, I use the first four ASCII control characters (in uri escape form) for +,*,! and comma. Therefore, this will replace + by %00 , by %01 ! by %02 and * by %03, then when you press 'i' in cursor mode, the %00 will become +, %01 will become , and so on.

nullpointer (

WeeChat Screenshot

/alias add nullpointer /exec -sh -hsignal nullpointer $* 2>&1 | curl -sfSF file=@-
/trigger add nullpointer hsignal nullpointer
/trigger set nullpointer regex "/\n//out"
/trigger set nullpointer command "/command -buffer ${buffer.full_name} core /input delete_line;/command -buffer ${buffer.full_name} core /input insert ${out}"

This allow you to type /nullpointer uptime for example, to send the output of the uptime command to Your input bar content will be replaced by the url of the paste. This way you can visit the URL to see if there is sensitive information before giving the url to everyone. You may wonder why I didn't used something like: _/exec -sh -pipe "/input delete_line;/input insert " $* 2>&1 | curl -sF c=@- Well If we use this, the input bar will be filled with the command and not the url.

Dev info

WeeChat Screenshot

/trigger add devinfo hsignal devinfo
/trigger set devinfo conditions ${err}==
/trigger set devinfo regex "/([0-9]{4})-01-([0-9]{2})/January ${re:2} ${re:1}/out /([0-9]{4})-02-([0-9]{2})/February ${re:2} ${re:1}/out /([0-9]{4})-03-([0-9]{2})/March ${re:2} ${re:1}/out /([0-9]{4})-04-([0-9]{2})/April ${re:2} ${re:1}/out /([0-9]{4})-05-([0-9]{2})/May ${re:2} ${re:1}/out /([0-9]{4})-06-([0-9]{2})/June ${re:2} ${re:1}/out /([0-9]{4})-07-([0-9]{2})/July ${re:2} ${re:1}/out /([0-9]{4})-08-([0-9]{2})/August ${re:2} ${re:1}/out /([0-9]{4})-09-([0-9]{2})/September ${re:2} ${re:1}/out /([0-9]{4})-10-([0-9]{2})/October ${re:2} ${re:1}/out /([0-9]{4})-11-([0-9]{2})/November ${re:2} ${re:1}/out /([0-9]{4})-12-([0-9]{2})/December ${re:2} ${re:1}/out /.*/\n${out}/out /.*/${out}/stable /.*/${out}/stable_date /.*/${out}/devel /.*/${out}/next_stable_date /.*\nstable:([^\n]+).*/The stable version of WeeChat is ${re:1}./stable /.*\nstable_date:([^\n]+).*/It is the stable version since ${re:1}${info:ruby_eval,require 'date'; print ' (' + ( - Date.parse('${re:1}').mjd).to_s + ' days)'}./stable_date /.*\ndevel:([^\n]+).*/The devel version of WeeChat is ${re:1}./devel /.*\nnext_stable_date:([^\n]+).*/The next stable should be release around ${re:1}${info:ruby_eval,require 'date'; print ' (' + (Date.parse('${re:1}').mjd - + ' days)'}./next_stable_date"
/trigger set devinfo command "/command -buffer ${buffer.full_name} * /say ${stable} ${stable_date} ${devel} ${next_stable_date}"

/alias add devinfo /exec -norc -timeout 5 -hsignal devinfo url:    

Thi alias send info about the current stable version of WeeChat and the next stable to the channel. The alias call exec and the output of exec is send as a hsignal. So the trigger handle the output.

translate with translate-shell (need the escape_shell_single_quote trigger)

WeeChat Screenshot

/trigger add translate_modifier modifier weechat_print
/trigger set translate_modifier conditions "${tg_tags} =~ ,exec_cmd_translated_(text|lang),"
/trigger set translate_modifier regex "/.*/${color:*_31}${if:${tg_tags}=~,exec_cmd_translated_text,?Translation:Language}${color:reset}\t${tg_message_nocolor}/"

/key bindctxt cursor @chat(*):t /window ${_window_number};/command -buffer ${_buffer_full_name} * /exec -norc -name translated_text trans -brief -target fr -no-auto '${info:escape_shell_single_quote,${_chat_line_message}}';/cursor stop
/key bindctxt cursor @chat(*):l /window ${_window_number};/command -buffer ${_buffer_full_name} * /exec -norc -name translated_lang trans -brief -no-auto -id '${info:escape_shell_single_quote,${_chat_line_message}}';/cursor stop
/key bindctxt cursor @chat(*):d /window ${_window_number};/command -buffer ${_buffer_full_name} * /exec -norc -name translated_dict -n trans -dictionary -no-auto '${info:escape_shell_single_quote,${_chat_word}}';/cursor stop

This let you translate text with the translate-shell program (package has the same name, at least for Debian). If you want to translate something someone said, press the middle mouse button on the message then press 't'. If you want to know the language of the text, press 'l' instead. Finally, you can press 'd' this will open a buffer and call translate-shell in dictionary mode. The trigger will beautify the output of translate-shell.


/set weechat.look.highlight *pascalpoitras*
/buffer_autoset add irc.bitlbee.#twitter_pascalpoitras* highlight_words freenode,snoonet,*weechat*
/buffer_autoset add irc.bitlbee.#LET highlight_regex .*
/buffer_autoset add irc.bitlbee.#deals highlight_regex .*
/buffer_autoset add irc.freenode.##reddit-hockey highlight_regex (^GOAL: MTL.*|^Le But: MTL.*)


Upgrade Scripts

/trigger add upgrade_scripts signal day_changed
/trigger set upgrade_scripts command "/script update;/wait 10s /script upgrade"

This trigger will update the local script cache and then upgrade all the installed scripts at midnight.

Friend Birthday

/trigger add marie_birthday signal day_changed
/trigger set marie_birthday conditions "${tg_signal_data} =~ 03-22$"
/trigger set marie_birthday command "/command -buffer ${} ruby /ruby eval -o print "BONNNE FÊTEEEE!!! BON #{${date:%Y} - 1984}ieme anniversaire!!!""

This trigger will be triggered the March 22 of each years at midnight to tell my friend "happy birthday"

Holiday Friend

/trigger add holiday_friend signal day_changed
/trigger set holiday_friend conditions "${info:holiday,${date:%d-%m}}"
/trigger set holiday_friend command "/command -buffer ${} irc /msg * ${info:holiday,${date:%d-%m}}"

This trigger will check if today is a holiday (using the holiday_utils trigger so you need to add it. You can find it in the next section.) if so, I will tell my friend Merry Christmas, or Happy new year (so she can't be angry).

Nick Validation

WeeChat Screenshot

/trigger add modifier_is_nick_valid modifier input_text_display 
/trigger set modifier_is_nick_valid conditions "${tg_string_nocolor} =~ ^/nick .+ && ${} == irc"
/trigger set modifier_is_nick_valid regex "==/nick (.+)==${re:1}==tg_string_nocolor ===/nick (.+)===/nick ${if:${info:irc_is_nick,${tg_string_nocolor}}&&${cut:${info:irc_server_isupport_value,${server},NICKLEN},,${tg_string_nocolor}}==${tg_string_nocolor}?${color:*green}:${color:*red}}${re:1}      -- NICKLEN:${color:-bold} ${info:perl_eval,print ${info:irc_server_isupport_value,${server},NICKLEN} - (${buffer.input_buffer_length} - 6) . ' /'} ${info:irc_server_isupport_value,${server},NICKLEN}  ${color:bold}Allowed Chars: ${color:-bold}${esc:a-zA-Z0-9_-\[]{}^`|}===tg_string"

This trigger will give you hint about max nickname length and available character in nickname and will also tell you if the nick is valid (green) or not (red). Note that it doesn't works with -all option of the /nick command.

hook_info triggers


/trigger add escape info escape
/trigger set escape conditions "${tg_arguments}"
/trigger set escape regex "/.*/${tg_arguments}/tg_info ==\\\\==\\\\== /'/\'/"

This info is used almost everytime I call ${info:ruby_eval or /ruby eval. It will escape any ' and any \ in the string before giving the result to ruby. I always call ruby with single quote string. It should also works with python and perl because single quote behave the same in these language AFAIK. So if you use double quote string, you need a different info.

example: /eval -n ${info:ruby_eval,puts '${info:escape,Hi' Everyone}'} will result in Hi' Everyone

escape shell single quote

/trigger add escape_shell_single_quote info escape_shell_single_quote
/trigger set escape_shell_single_quote conditions "${tg_arguments}"
/trigger set escape_shell_single_quote regex "/.*/${tg_arguments}/tg_info /'/'\''/"

if you use /exec with -sh and the option exec_command_shell is set to bash, escape sequence like \n will not be interpreted as a new line. This is what I want so I configured this option to bash (if you use my configuration you should do the same). In zsh, the \n will be interpreted as a new line in a single quoted string. By default the option is set to sh but on my system /bin/sh is a symbolic link to dash and dash behave like zsh. You need to keep this in mind! And don't forget, this only works for single quote string, if you want to use it in a double quote string you need to create another info or modify this one.

example: /eval /exec -norc -sh echo '${info:escape_shell_single_quote,${plugins.var.text}}' | cowsay will display a cow saying the content of plugins.var.text option

replace (require escape trigger)

/trigger add replace info replace
/trigger set replace conditions "${tg_arguments} =~ ^,[^,]+,[^,]*,.+$ || ${tg_arguments} =~ ^=[^=]+=[^=]*=.+$ || ${tg_arguments} =~ ^#[^#]+#[^#]*#.+$"
/trigger set replace regex "/.*/${tg_arguments}/tg_info /.*/${info:ruby_eval, arguments = '${info:escape,${tg_arguments}}'[1..-1].split('${info:escape,${tg_arguments}}'[0], 3);  puts arguments[2].gsub([0]), arguments[1])}/tg_info"

Replace any match (global) of the pattern (argument #1) to the replacement given by argument #2 in the string (argument #3)

example: /eval ${info:replace,,[aeiou],*,hello} will return h*ll*.

you can use a different delimiter (# or =) if your regex or the replacement contains a comma

example: /eval ${info:replace,#,##I like banana, apple and orange} will result in I like banana apple and orange (no comma)

And yes, you need the comma after replace (no matter the delimiter). So the syntax is ${info:replace,DELIMITERregexDELIMITERreplacementDELIMITERtext}

replace with re2 (require escape trigger)

/trigger add replace2 info replace2
/trigger set replace2 conditions "${tg_arguments} =~ ^,[^,]+,[^,]*,.+$ || ${tg_arguments} =~ ^=[^=]+=[^=]*=.+$ || ${tg_arguments} =~ ^#[^#]+#[^#]*#.+$"
/trigger set replace2 regex "/.*/${tg_arguments}/tg_info /.*/${info:ruby_eval, require 're2'; arguments = '${info:escape,${tg_arguments}}'[1..-1].split('${info:escape,${tg_arguments}}'[0], 3); puts RE2.GlobalReplace(arguments[2], arguments[0], arguments[1])}/tg_info"

The difference between replace and replace2 is that replace use Oniguruma engine (if you are using Ruby 1.9 or later) while replace2 use re2. re2 does not support backreference and lookahead/lookbehind but is perfectly safe to use with untrusted data. You need to install the re2 library.

example: /eval ${info:replace2,,[aeiou],*,hello} will return h*ll*.

you can use a different delimiter (# or =) if your regex or the replacement contains a comma

example: /eval ${info:replace2,#,##I like banana, apple and orange} will result in I like banana apple and orange (no comma)

And yes, you need the comma after replace2 (no matter the delimiter). So the syntax is ${info:replace2,DELIMITERregexDELIMITERreplacementDELIMITERtext}


/trigger add length_utils info length
/trigger set length_utils regex "/.*/${if:${tg_arguments}?${info:ruby_eval,puts '${info:escape,${tg_arguments}}'.size.to_s}:0}/tg_info"

example: /eval -n ${info:length,weechat} will result in 7

increment and decrement

/trigger add inc_utils info inc
/trigger set inc_utils conditions "${tg_arguments} =~ ^(-?[0-9]+)*,[0-9]+$"
/trigger set inc_utils regex "/^,/1,/tg_arguments /.*/${tg_arguments}/the_number /^(-?[0-9]+),[0-9]+/${re:1}/the_number /^-?[0-9]+,([0-9]+)/${re:1}/tg_arguments /.*/${info:ruby_eval, puts((${tg_arguments} + ${the_number}).to_s)}/tg_info"

Used to increment but also decrement if you use a negative number. If you omit number in argument #1, it will increment argument #2 by one

example: /eval -n ${info:inc,,7} and ${info:inc,5,${info:length,weechat}} will result 8 and 12

irc buffers stats

/trigger add ircbufstats_utils info ircbufstats
/trigger set ircbufstats_utils conditions "${tg_arguments} =~ ^(all|server|channel|private|query)$"
/trigger set ircbufstats_utils regex "/^query$/private/tg_arguments /.*/${info:ruby_eval, infolist = Weechat.infolist_get('buffer', '', ''); buffers_stats = do |hash,key| hash[key] = 0 end; while Weechat.infolist_next(infolist) != 0 do buffer_ptr = Weechat.infolist_pointer(infolist, 'pointer'); buffers_stats[Weechat.buffer_get_string(buffer_ptr, 'localvar_type')] += 1 if Weechat.infolist_string(infolist, 'plugin_name') == 'irc' end if infolist != 0; Weechat.infolist_free(infolist); puts '${tg_arguments}' == 'all' ? [buffers_stats['server'], buffers_stats['channel'], buffers_stats['private']].join(' ') : buffers_stats['${tg_arguments}'].to_s}/tg_info"

example: /eval -n I am on ${info:ircbufstats,server} networks and ${info:ircbufstats,channel} channels with ${info:ircbufstats,private} queries will result in I am on 3 networks and 17 channels with 1 queries

example: same but faster (need the replace trigger) /eval -n ${info:replace,,([0-9]+) ([0-9]+) ([0-9]+),I am on \1 networks and \2 channels with \3 queries,${info:ircbufstats,all}}


/trigger add holiday_utils info holiday
/trigger set holiday_utils conditions "${tg_arguments} =~ ^(0[1-9]|[1-2][0-9]|3[0-1])-(0[1-9]|1[0-2])$"
/trigger set holiday_utils regex "/.*/${tg_arguments}/ /01-01/HAPPY NEW YEAR!/ /25-12/MERRY CHRISTMAS!/ /[0-9][0-9]-[0-9][0-9]//"

this info is useful for the weechat.look.day_change_message_1_date and _2dates. See these options at the bottom of my configuration. This trigger is also used from the holiday_friend trigger.

example: /eval ${if:${info:holiday,${date:%d-%m}}?Yes! today is a holiday \o/ -- ${info:holiday,${date:%d-%m}} all!:Go to work!} will result in Yes! today is a holiday -- MERRY CHRISTMAS! all! if, of course we are December 25!


/key bindctxt cursor @item(buffer_nicklist):v /window ${_window_number};/voice ${nick}
/key bindctxt cursor @item(buffer_nicklist):o /window ${_window_number};/op ${nick}
/key bindctxt cursor @item(buffer_nicklist):V /window ${_window_number};/devoice ${nick}
/key bindctxt cursor @item(buffer_nicklist):O /window ${_window_number};/deop ${nick}
/key bindctxt cursor @chat(*):s /window ${_window_number};/slap ${_chat_line_nick};/cursor stop
/key bindctxt cursor @item(buffer_nicklist):s /window ${_window_number};/slap ${nick};/cursor stop
/key bindctxt cursor @item(buflist):h /command -buffer ${full_name} irc /allchan -current buffer hide;/command -buffer ${full_name} irc /allpv -current buffer hide;/cursor stop
/key bindctxt cursor @item(buflist):H /command -buffer ${full_name} irc /allchan -current buffer unhide;/command -buffer ${full_name} irc /allpv -current buffer unhide;/cursor stop
/key bindctxt cursor @chat(*):g /window ${_window_number};/customgrep ${_chat_line_nick};/cursor stop
/key bindctxt cursor @item(buffer_nicklist):g /window ${_window_number};/customgrep ${nick};/cursor stop
/key bind ctrl-G /bar set buflist size 15;/bar set buflist_hotlist size 4;/repeat -interval 70ms 8 /eval /bar set buflist size ${info:inc,1,${}};/wait 560ms /repeat -interval 70ms 8 /eval /bar set buflist size ${info:inc,-1,${}};/wait 1120ms /repeat -interval 70ms 4 /eval /bar set buflist_hotlist size ${info:inc,-1,${}};/wait 1400ms /repeat -interval 70ms 4 /eval /bar set buflist_hotlist size ${info:inc,1,${}};/wait 1680ms /repeat -interval 2s 2 /window zoom

/key bindctxt cursor @chat(*):a /command -buffer ${buffer.full_name} core /input insert ${_chat_bol}\x20;/cursor stop
/key bindctxt cursor @chat(*):e /command -buffer ${buffer.full_name} core /input insert ${_chat_eol}\x20;/cursor stop
/key bindctxt cursor @chat(*):w /command -buffer ${buffer.full_name} core /input insert ${_chat_word}\x20;/cursor stop

The ctrl-G is probably useless for you, I created this to automate the action i need to do when I create the gif at the top of the config, this resize the buflist and zoom the window so we can see that conky appears on the statusbar when window is zoomed.

Others Keyboard shortcuts

/key bind meta-meta2-A /bar scroll nicklist * -100%
/key bind meta-meta2-B /bar scroll nicklist * +100%
/key bind meta2-A /input history_global_previous
/key bind meta2-B /input history_global_next


/alias add ame allchan -current /me
/alias add amsg allchan -current /msg *
/alias add cq allpv /buffer close
/alias add slap /me slaps $1- around a bit with a large trout
/alias add customgrep /input delete_line;/input insert /grep log */$server/$channel.* -a ^\[\d{2}:\d{2}:\d{2}\] <%{escape $1}>\x20
/alias add znc /quote znc
/alias add fu /say (╹◡╹)凸 $*
/alias addcompletion %(weechat_commands) multicomm /alias add temp $*;/temp
/alias add funnyversion /eval ${if:$*==?${info:ruby_eval,print %W[mIRC irssi KVIrc HexChat AdiIRC BitchX].sample}:$*} ${info:version} (git: ${info:version_git}) [compiled on ${info:date}]
/alias add savechan /allserv mute unset irc.server.$server.autojoin;/allchan mute autojoinem add;/mute unset irc.server.undernet.autojoin
/alias add change-color /fset c:${type_en} == color && ${value} == $1;/command -buffer fset.fset core /input send m:*;/fset -add -$1;/fset -add $2    

The multicomm alias is an alternative to /eval -s, but more "secure". If you use eval -s for this purpose (execute more than one command) but you forget that thing like secure variables will be evaluate this can be very bad. The change-color alias allow you to change all colors options corresponding to a certain value with another one.

The savechan alias will first remove every channels in the autojoin option (because I dont want to keep the channels that I'm not there anymore) then it add all the channels but then unset the option for undernet because I dont want to join any channel on this network (No I can't combine allserv and allchan and exclude undernet). Also note that I used allserv unset instead of unset -mask: because I don't want to remove the channels of servers I am not currently connected to.


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

Custom join color

/set weechat.color.chat_prefix_join 121
/set weechat.color.chat_host 31
/set irc.color.message_join 121

The weechat.color.chat_host option will also set this color for part and quit. To have a different color, for example, a host in red for parts and quits and green for joins, see this.

Custom part and quit

/set weechat.color.chat_prefix_quit 131
/set irc.color.message_quit 131

exec options

/set bash

The remaining IRC options

/set irc.server_default.away_check 5
/set irc.server_default.away_check_max_nicks 25
/set irc.color.nick_prefixes "q:lightred;a:lightcyan;o:121;h:lightmagenta;v:229;*:lightblue"
/set "*!*@$host"
/set irc.look.buffer_switch_autojoin off
/set irc.look.buffer_switch_join off
/set irc.look.color_nicks_in_nicklist on
/set irc.look.part_closes_buffer on

The remaining Weechat options

/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.buffer_notify_default message
/set weechat.look.buffer_time_format "${253}%H${245}%M"
/set weechat.look.color_inactive_message off
/set weechat.look.color_inactive_prefix off
/set weechat.look.color_inactive_prefix_buffer off
/set weechat.look.color_inactive_window off
/set weechat.look.day_change_message_1date "▬▬▶ ${if:${info:holiday,%d-%m}?${info:holiday,%d-%m}:%a, %d %b %Y} ◀▬▬"
/set weechat.look.day_change_message_2dates "▬▬▶ ${if:${info:holiday,%%d-%%m}?${info:holiday,%%d-%%m}:%%a, %%d %%b %%Y} (%a, %d %b %Y) ◀▬▬"
/set weechat.look.item_buffer_filter "•"
/set weechat.look.prefix_align_min 0
/set weechat.look.prefix_align_max 10
/set weechat.look.prefix_join "▬▬▶"
/set weechat.look.prefix_quit "◀▬▬"
/set weechat.look.prefix_suffix "│"
/set weechat.look.read_marker_string "─"
/set weechat.look.separator_horizontal ""

/set weechat.color.bar_more 229
/set weechat.color.chat_highlight lightred
/set weechat.color.chat_highlight_bg default
/set weechat.color.chat_nick_colors "cyan,magenta,green,brown,lightblue,lightcyan,lightmagenta,lightgreen,blue"
/set weechat.color.chat_prefix_more 31
/set weechat.color.chat_prefix_suffix 31
/set weechat.color.chat_read_marker 31
/set weechat.color.chat_time 239
/set weechat.color.chat_delimiters 31
/set weechat.color.separator 31
/set weechat.color.status_data_highlight 163
/set weechat.color.status_data_msg 229
/set weechat.color.status_data_private 121
/set weechat.color.status_more 229
/set weechat.color.status_name 121
/set weechat.color.status_name_ssl 121

The following command will let you run all the commands of my configuration (not really recommended, you should take only what you want and understand)

First, type the following

/secure passphrase <pass>
/secure set freenodepass <pass>
/secure set snoonetpass <pass>
/secure set undernet_userpass <user> <pass>
/secure set undernet_secret <TOTP secret>
/secure set relaypass <pass>
/script install
/secure set mariechannel <buffer fullname of my friend's channel>

Once scripts are installed

/exec -sh -oc curl -sfS | sed -E 's/^\s+//;/^(\/secure|\/script|\/ruby)/d;/^\//!d'
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment