Skip to content

Latest commit

 

History

History
80 lines (53 loc) · 2.49 KB

README.md

File metadata and controls

80 lines (53 loc) · 2.49 KB

done

A fish plugin to automatically receive notifications when long processes finish.

Stability: Stable Release version fish >=2.3.0 License: MIT


Just go on with your normal life. You will get a notification when a process takes more than 5 seconds finish, and the terminal window not in the foreground.

After installing you could type, for instance sleep 6, and start using other app. After 6 seconds you should get a notification.

Install

Using fisherman

fisher install done

Manually

curl -Lo ~/.config/fish/functions/humanize_duration.fish --create-dirs https://raw.githubusercontent.com/fisherman/humanize_duration/master/humanize_duration.fish
curl -Lo ~/.config/fish/conf.d/done.fish --create-dirs https://raw.githubusercontent.com/fisherman/done/master/conf.d/done.fish

Dependencies

If you want notifications with icons on macOS, please install terminal-notifier

brew install terminal-notifier

Update

fisher update

Subscribe to the newsletter to be notified of new versions.

Configure

Only display notifications if a command takes more than a certain amount of time

`set -U __done_min_cmd_duration 5000  # default: 5000 ms`

Prevent specific commands from triggering notifications.

This is useful to exclude commands like git commit for instance, since it could trigger unwanted notifications if it is configured to use an external editor.

set -U __done_exclude 'git (?!push|pull)'  # default: all git commands, except push and pull. accepts a regex.

Support

  • fish 2.3.0+
  • macOS 10.8+ via Notification Center.
  • Linux via notify-send. Otherwise bell sound is played.
  • Windows: Upvote franciscolourenco#5 if interested.

Credits