https://github.com/jeffwilliams/irssi_screenaway

When using irssi inside GNU screen, change the user's nick and mark the user away after a specified idle time (of not typing).
https://github.com/jeffwilliams/irssi_screenaway

Last synced: 11 days ago
JSON representation

When using irssi inside GNU screen, change the user's nick and mark the user away after a specified idle time (of not typing).

• Host: GitHub
• URL: https://github.com/jeffwilliams/irssi_screenaway
• Owner: jeffwilliams
• License: mit
• Created: 2015-01-17T21:24:55.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2015-01-17T21:33:42.000Z (almost 10 years ago)
• Last Synced: 2023-03-12T06:39:21.730Z (over 1 year ago)
• Language: Perl
• Size: 113 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        

# IRSSI script: screenaway

Detect user inactivity using screen's 'idle' command.

 

This script requires irssi to be run inside GNU screen to work properly.

GNU screen has a feature activated by the command 'idle': when the user has been

idle (hasn't typed any keys) for a specified number of seconds it runs a shell

command specified by the 'blankerprg' setting.

This script uses that functionality to implement auto-away functionality in 

irssi. When screen detects the user is idle it executes a script (`screenaway_blanker.pl`)

that notifies this irssi script that the user is away. The user's nick is changed to the 

specified value and the /AWAY command is run. 

When the user presses a key, screen terminates the `screenaway_blanker.pl` script which

this irssi script detects, and on that event changes the user's nick back to it's previous

setting and unmarks the user as away.

## Installation:

1. Copy `screenaway.pl` and `screenaway_blanker.pl` to the directory `~/.irssi/scripts`. 

2. Make a link to `screenaway.pl` from `~/.irssi/scripts/autorun` if you want it started automatically.

 

## Settings:

 This script registers the following settings in irssi which can be modified using the `/set` command, i.e.

 `/set screenaway_nick bob-away`. Query using `/set screenaway`.

    Setting               Default           Desc

    -------               -------           ----

    'screenaway_nick'    'bob-away'         The nick to set when away.

    'screenaway_timeout'  300               The number of seconds the user may be idle before being marked away.

    'screenaway_reason', 'AFK for a while'  Reason to pass to the /away command

    'screenaway_debug',   0                 Set this to 1 to enable debug messages. They'll appear in the main irssi window.            

 Inside irssi, you can load this script using `/script load screenaway.pl` and unload using `/script unload screenaway.pl`