jhradilek / irssi-notifications

An Irssi script to notify the user about incoming messages

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

irssi-notifications

Description

The notifications script for Irssi uses desktop notifications to inform the user about incoming messages.

Installation

IMPORTANT: A working installation of the Net::DBus module for Perl is required for this script to function. In Fedora, this module is provided by the perl-Net-DBus package. In Debian and Ubuntu, the package is named libnet-dbus-perl.

Irssi looks for additional scrips in the in the ~/.irssi/scripts/ directory. To make sure that this directory exists, type the following at a shell prompt:

install -d ~/.irssi/scripts/autorun/

To install the notifications script, change to the directory with your local copy of the repository and type:

cp notifications.pl ~/.irssi/scripts/

This copies the notifications.pl file to the ~/.irssi/scripts/ directory. You can also configure Irssi to load the script automatically at startup. To do so, create a symbolic link to that file in the ~/.irssi/scripts/autorun/ directory:

ln -s ~/.irssi/scripts/{,autorun/}notifications.pl

The script is loaded the next time you start the client.

Usage

Loading the Script

To load the notifications script in Irssi, run the following Irssi command:

/script load notifications

Unloading the Script

To unload the notifications script from Irssi, run the following Irssi command:

/script unload notifications

Filtering Notifications

The notifications script provides a number of boolean variables that allow you to enable or disable certain behavior. To change the value of any of these variables, run the following Irssi command:

/set <variable_name> ON|OFF

The available variables are as follows:

Variable Description
notifications_private_messages Enables notifications for private messages. The default value is ON.
notifications_public_messages Enables notifications for messages in an IRC channel. The default value is ON.
notifications_indirect_messages Enables notifications for messages that mention the user only indirectly. The default value is OFF.
notifications_active_window Enables notifications for messages in an active window. The default value is OFF.
notifications_dcc_messages Enables notifications for incoming DCC messages and DCC CHAT messages. The default value is ON.

Copyright

Copyright © 2012, 2014, 2019 Jaromir Hradilek

This program is free software; see the source for copying conditions. It is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

About

An Irssi script to notify the user about incoming messages


Languages

Language:Perl 100.0%