Chanmon is a perl script for Weechat 0.3.0+ that allows you to track IRC channels in a new buffer, without merging them using Weechat’s buffer merge feature
Current Version: 2.5 [ dl ]
(released: 16-08-2014)
Command Usage:
- /chanmon [help] | [monitor [channel [server]]] | [dynmon] | [clean default|orphan|all] | clearbar
Command wrapper for chanmon commands - /monitor [channel] [server] is used to toggle a channel monitoring on and off, this can be used in the channel buffer for the channel you wish to toggle, or be given with arguments e.g. /monitor #weechat freenode
- /dynmon is used to toggle ‘Dynamic Channel Monitoring’ on and off, this will automagically stop monitoring the current active buffer, without affecting regular settings (Default is off)
- /chanclean default|orphan|all will clean the config section of default ‘on’ entries, channels you are no longer joined, or both
- /chanmon clearbar will clear the contents of chanmon’s bar output
Hidden toggles:
‘chanmon’ stores all it’s settings in Weechat’s plugins.conf, the following can be set there, by using /set or the ‘iset’ plug-in
- alignment –
/set plugins.var.perl.chanmon.alignment "channel"
The config setting “alignment” can be changed to;
“channel”, “schannel”, “nchannel”, “channel,nick”, “schannel,nick”, “nchannel,nick”
to change how the monitor appears
The ‘channel’ value will show: “#weechat”
The ‘schannel’ value will show: “6”
The ‘nchannel’ value will show: “6:#weechat”
(Default: ‘channel’) - short_names –
/set plugins.var.perl.chanmon.short_names "on|off"
Setting this will trim the network name from chanmon, ala buffers.pl
(Default: ‘on’) - merge_private –
/set plugins.var.perl.chanmon.merge_private
Setting this to ‘on’ will merge private messages to chanmon’s display - color_buf –
/set plugins.var.perl.chanmon.color_buf "on|off|colour"
This turns coloured buffer names on or off, you can also set a single fixed colour by using a weechat colour name.
This must be a valid colour name, or weechat will likely do unexpected things 🙂
(Default: ‘on’) - show_aways –
/set plugins.var.perl.chanmon.show_aways "on|off"
Toggles showing the Weechat away messages
(Default: ‘off’) - logging –
/set plugins.var.perl.chanmon.logging "on|off"
Toggles logging status for chanmon buffer
(default: off) - output –
/set plugins.var.perl.chanmon.output
Changes where output method of chanmon; takes either “bar” or “buffer”
(default; buffer) - bar_lines –
/set plugins.var.perl.chanmon.bar_lines
Changes the amount of lines the output bar will hold.
(Only appears once output has been set to bar, defaults to 10) - nick_prefix –
/set plugins.var.perl.chanmon.nick_prefix
nick_suffix –/set plugins.var.perl.chanmon.nick_suffix
Sets the prefix and suffix chars in the chanmon buffer
(Defaults to <> if nothing set, and blank if there is) - servername.#channel
servername is the internal name for the server (set when you use /server add)
#channel is the channel name, (where # is whatever channel type that channel happens to be)
Optional:
# Ideal set up:
# Split the layout 70/30 (or there abouts) horizontally and load
# Optionally, hide the status and input lines on chanmon
/window splith 70 –> open the chanmon buffer
/set weechat.bar.status.conditions "${window.buffer.full_name} != perl.chanmon"
/set weechat.bar.input.conditions "${window.buffer.full_name} != perl.chanmon".bar.status.conditions “active”
History:
- 2014-08-16, KenjiE20
v2.5: -add: clearbar command to clear bar output
-add: firstrun output prompt to check the help text for set up hints as they were being missed and update hint for conditions to use eval
-change: Make all outputs use the date callback for more accurate timestamps (thanks Germainz) - 2013-12-04, KenjiE20
v2.4: -add: Support for eval style colour codes in time format used for bar output - 2013-10-10, KenjiE20
v2.3.3.1: -fix: Typo in closed buffer warning - 2013-10-07, KenjiE20
v2.3.3: -add: Warning and fixer for accidental buffer closes - 2013-01-14, KenjiE20
v2.3.2: -fix: Let bar output use the string set in weechat’s config option
-add: github info
-change: Ideal set up -> Example set up - 2012-04-15, KenjiE20
v2.3.1: -fix: Colour tags in bar timestamp string, bar error fixes from highmon - 2012-02-28, KenjiE20
v2.3: -feature: Added merge_private option to display private messages (default: off) - 2010-12-22, KenjiE20
v2.2: -change: Use API instead of config to find channel colours, ready for 0.3.4 and 256 colours - 2010-12-05, KenjiE20
v2.1.3: change: /monitor is now /chmonitor to avoid command conflicts (thanks m4v)
(/chanmon monitor remains the same)
-fix: Add command list to inbuilt help - 2010-09-30, KenjiE20
v2.1.2: -fix: logging config was not correctly toggling back on (thanks to sleo for noticing) - 2010-09-20, m4v
v2.1.1: -fix: chanmon wasn’t detecting buffers displayed on more than one window - 2010-08-27, KenjiE20
v2.1: -feature: Add ‘nchannel’ option to alignment to display buffer and name - 2010-04-25, KenjiE20
v2.0: Release as version 2.0 - 2010-04-24, KenjiE20
-fix: No longer using hard-coded detection for ACTION and TOPIC messages. Use config settings for ACTION printing - 2010-04-15, KenjiE20
v1.9: Rewrite for v2.0
-feature: /monitor takes arguments
-feature: Added /chanclean for config cleanup
-feature: Buffer logging option (default: off)
-feature: Selectable output (Bar/Buffer (default))
-feature:- /chanmon is now a command wrapper for all commands
- /help chanmon gives command help
- /chanmon help gives config help
-code change: Made more subs to shrink the code down in places
-fix: Stop chanmon attempting to double load/hook - 2010-02-10, m4v
v1.7.1: -fix: chanmon was leaking infolists, changed how chanmon detects if the buffer is displayed or not. - 2010-01-25, KenjiE20
v1.7: -fixture: Let chanmon be aware of nick_prefix/suffix and allow custom prefix/suffix for chanmon buffer
(Defaults to <> if nothing set, and blank if there is)
-fix: Make dynamic monitoring aware of multiple windows rather than just the active buffer
(Thanks to m4v for these) - 2009-09-07, KenjiE20
v1.6: -feature: coloured buffer names
-change: highmon version sync - 2009-09-05, KenjiE20
v1.5: -fix: disable buffer highlight - 2009-09-02, KenjiE20
v.1.4.1 -change: Stop unsightly text block on ‘/help’ - 2009-08-10, KenjiE20
v1.4: -feature: In-client help added
-fix: Added missing help entries
Fix remaining ugly vars - 2009-07-09, KenjiE20
v.1.3.3 -fix: highlight on the channel monitor when someone /me highlights - 2009-07-04, KenjiE20
v.1.3.2 -fix: use new away_info tag instead of ugly regexp for away detection
-code: cleanup old raw callback arguement variables to nice neat named ones - 2009-07-04, KenjiE20
v.1.3.1 -feature(tte): Hide /away messages by default, change ‘show_aways’ to get them back - 2009-07-01, KenjiE20
v.1.3 -feature(tte): Mimic buffers.pl ‘short_names’ - 2009-06-29, KenjiE20
v.1.2.1 -fix: let the /monitor message respect the alignment setting - 2009-06-19, KenjiE20
v.1.2 -feature(tte): Customisable alignment
Thanks to ‘FreakGaurd’ for the idea - 2009-06-14, KenjiE20
v.1.1.2 -fix: don’t assume chanmon buffer needs creating
fixes crashing with /upgrade - 2009-06-13, KenjiE20
v.1.1.1 -code: change from True/False to on/off for weechat consistency
Settings WILL NEED to be changed manually from previous versions - 2009-06-13, KenjiE20
v1.1: -feature: Dynamic Channel Monitoring,
don’t display messages from active channel buffer
defaults to Disabled
Thanks to ‘sjohnson’ for the idea
-fix: don’t set config entries for non-channels
-fix: don’t assume all channels are # - 2009-06-12, KenjiE20
v1.0.1: -fix: glitch with tabs in IRC messages - 2009-06-10, KenjiE20
v1.0: Initial Public Release