s3rvac/ weechat-notify-send

(v0.9) over 1 year ago

Python

weechat

Need help with weechat-notify-send?

Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

s3rvac

160 Stars

17 Forks

MIT License

217 Commits

6 Opened issues

Description

A WeeChat script that sends highlight and message notifications through notify-send.

Services available

Need anything else?

Contributors list

Petr Zemek s3rvac

# 9,468

Python

C++

weechat

analysi...

208 commits

Readme

weechat-notify-send

Name: weechat-notify-send
Brand: weechat-notify-send
SKU: //s3rvac/weechat-notify-send
Rating: 2.15 (160 reviews)

A WeeChat script that sends highlight and message notifications through notify-send. It requires libnotify, which provides the

notify-send

application.

Note that the exact appearance depends on the configuration of your notification system as well as on the used icon.

Requirements

Python 2.7 or Python >= 3.6 (either CPython or PyPy)
```
notify-send
```
provided by libnotify
- Debian: libnotify-bin
- Ubuntu: libnotify-bin
- Arch Linux: extra/libnotify

Installation

Put the
```
notify_send.py
```
script 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
```

Options

The script allows you to set the following options, either by running

/set
plugins.var.python.notify_send.XXX YYY

or 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
```
0
```
to disable this feature (i.e. all notifications will be shown). Default:
```
500
```
milliseconds.

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
```
off
```
to keep the notification. Default:
```
on
```
.
```
urgency
```
: Notification urgency (
```
low
```
,
```
normal
```
,
```
critical
```
). Default:
```
normal
```
.

License

Distributed under the MIT license. See the

LICENSE

file for more details.