artemave / zlong_alert.zsh

A plugin to alert you when a long-running command has finished

zlong_alert.zsh

zlong_alert.zsh will send a desktop notification and sound a bell to alert you when a command that has taken a long time (default: 15 seconds) has completed.

Desktop notifications are sent using notify-send on Linux and using alerter on MacOS.

---

Installation

Pre-requisite for MacOS only

Ensure that you downloaded the alerter binary from here, have placed it in your PATH, and given the file executable permissions before continuing with any of the installation methods.

zplug

zplug "kevinywlui/zlong_alert.zsh"

Oh My Zsh

1. Clone into $ZSH_CUSTOM/plugins/zlong_alert.
2. Add zlong_alert to plugins in .zshrc.

Manual

This script just needs to be sourced so add this to your .zshrc:

source /path/to/zlong_alert.zsh

---

Configuration

There are 4 variables you can set that will alter the behavior this script.

• zlong_duration (default: 15): number of seconds that is considered a long duration.
• zlong_ignore_cmds (default: "vim ssh"): commands to ignore.
• zlong_send_notifications (default: true): whether to send notifications.
• zlong_ignorespace (default: false): whether to ignore commands with a leading space

For example, adding the following anywhere in your .zshrc

zlong_send_notifications=false
zlong_duration=2
zlong_ignore_cmds="vim ssh pacman yay"

will alert you, without sending a notification, if a command has lasted for more than 2 seconds, provided that the command does not start with any of vim ssh pacman yay.

Changelog

See CHANGELOG

Credit

This script is the result of me trying to understand and emulate this gist: https://gist.github.com/jpouellet/5278239 My version fixes some things (possibly bugs?) that I did not like about the original version.