A WeeChat script that sends highlight and message notifications through notify-send.
A WeeChat script that sends highlight and message notifications through notify-send. It requires libnotify, which provides the
notify-sendapplication.
Note that the exact appearance depends on the configuration of your notification system as well as on the used icon.
notify-sendprovided by libnotify
notify_send.pyscript to
~/.weechat/python/.
Add a symbolic link to it in the
~/.weechat/python/autoload/directory to make the script load automatically when WeeChat starts:
$ cd ~/.weechat/python/autoload $ ln -s ../notify_send.py
The script allows you to set the following options, either by running
/set plugins.var.python.notify_send.XXX YYYor by using the iset.pl script.
notify_on_highlights. Send notifications on highlights. Default:
on.
notify_on_privmsgs. Send notifications on private messages. Default:
on.
notify_on_filtered_messages. Send notifications also on filtered (hidden) messages. Default:
off.
notify_when_away: Send also notifications when away. Default:
on.
notify_for_current_buffer: Send also notifications for the currently active buffer. Default:
on.
notify_on_all_messages_in_current_buffer: Send a notification on all messages in the currently active buffer. Default:
off.
notify_on_all_messages_in_buffers: A comma-separated list of buffers for which you want to receive notifications on all messages that appear in them. You can use either short names (
#buffer) or full names (
network.#buffer). Default:
''.
notify_on_all_messages_in_buffers_that_match: A comma-separated list of regex patterns of buffers for which you want to receive notifications on all messages that appear in them. The matching is done via
re.search(). Default:
''.
notify_on_messages_that_match: A comma-separated list of regex patterns for which you want to receive notifications for any message that matches the given regular expression. The matching is done via
re.search(). Default:
''.
min_notification_delay. A minimal delay in milliseconds between successive notifications from the same buffer. It is used to protect from floods/spam. Set it to
0to disable this feature (i.e. all notifications will be shown). Default:
500milliseconds.
ignore_messages_tagged_with: A comma-separated list of message tags for which no notifications should be shown. Default:
'notify_none,irc_join,irc_quit,irc_part,irc_status,irc_nick_back,irc_401,irc_402'.
ignore_buffers: A comma-separated list of buffers from which no notifications should be shown. You can use either short names (
#buffer) or full names (
network.#buffer). Default:
''.
ignore_buffers_starting_with: A comma-separated list of buffer prefixes from which no notifications should be shown. Default:
''.
ignore_nicks: A comma-separated list of nicks from which no notifications should be shown. Default:
'-,--,-->'.
ignore_nicks_starting_with: A comma-separated list of nick prefixes from which no notifications should be shown. Default:
''.
hide_messages_in_buffers_that_match: A comma-separated list of regex patterns for names of buffers from which you want to receive notifications without messages. Default:
''.
nick_separator: A separator to be put between a nick and a message. Default:
:.
escape_html: Escapes the
<,
>, and
&HTML characters in notification messages. Default:
on.
max_length: The maximal length of a notification (0 means no limit). Default: 72.
ellipsis: An ellipsis to be used for notifications that are too long. Default:
[..].
icon: A path to an icon to be shown in notifications. Default:
/usr/share/icons/hicolor/32x32/apps/weechat.png.
desktop_entry: Name of the desktop entry for WeeChat. Default:
weechat.
timeout: Time after which the notification disappears (in milliseconds). Set it to 0 to disable the timeout. Default: 5000 (5 seconds).
transient: When a notification expires or is dismissed, remove it from the notification bar. Set it to
offto keep the notification. Default:
on.
urgency: Notification urgency (
low,
normal,
critical). Default:
normal.
Copyright (c) 2015 Petr Zemek ([email protected]) and contributors.
Distributed under the MIT license. See the
LICENSEfile for more details.