A fish shell package to automatically receive notifications when long processes finish.
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.
fisher install franciscolourenco/done
curl -Lo ~/.config/fish/conf.d/done.fish --create-dirs https://raw.githubusercontent.com/franciscolourenco/done/master/conf.d/done.fish
fish-done package from AUR.
yay -S fish-done
- If you want notifications with icons on macOS, please install
brew install terminal-notifier
- If you are using https://swaywm.org please install
- If you are using Windows Subsystem for Linux (WSL) you may need to install wslu, but usually it is pre-installed.
fisher update franciscolourenco/done
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. Accepts a regex.
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. This is also useful with
set -U __done_allow_nongraphical 1 to prevent notifications for commands normally run interactively that you do not want to get done notifications for.
set -U __done_exclude 'git (?!push|pull)' # default: all git commands, except push and pull. accepts a regex.
Execute a custom command instead of showing the default notifications. The
done notification title and message can also be passed.
set -U __done_notification_command "your-command \$title \$message"
Play sound when showing notifications.
set -U __done_notify_sound 1
sway, do not show notifications for visible windows.
set -U __done_sway_ignore_visible 1
For Linux, set the urgency level for notifications sent via notify-send (low, normal, critical). The default is "normal" for regular commands, and "critical" for failed commands.
set -U __done_notification_urgency_level low set -U __done_notification_urgency_level_failure normal
Allow notifications to be sent on systems without graphical capabilities. Note this requires you to also set
set -U __done_allow_nongraphical 1
- fish 2.3.0+
- macOS 10.8+ via Notification Center.
- Linux via
notify-send. Otherwise bell sound is played.
- Windows 10 via Windows Subsystem for Linux (WSL) and PowerShell.
This project exists thanks to all the people who contribute. [Contribute].
Become a financial contributor and help us sustain our community. [Contribute]
Support this project with your organization. Your logo will show up here with a link to your website. [Contribute]
Done is MIT licensed. See LICENSE for details.