noti

Retrieve your credentials from the [Twilio] Project info tab. Set the following keys:

• twilio.accountsid: Your ACCOUNT SID.
• twilio.authtoken: Your AUTH TOKEN.
• twilio.numberto: The destination phone number.
• twilio.numberfrom: The sender phone number.

To use Pushover, you need two keys from your [Pushover] account:

1. pushover.userKey: Your User Key.
2. pushover.apiToken: An API Token generated by creating a new application of type "Script".

If a process is already running, you can use the --pwatch (or -w) flag followed by the process ID (PID) to trigger a notification when that specific PID disappears.

noti --pwatch $(pgrep docker-machine)

You can specify a custom configuration file using the --file flag. If not specified, noti searches for configuration in the following order:

1. ./.noti.yaml
2. $XDG_CONFIG_HOME/noti/noti.yaml

The basic usage of noti is to wrap a command. When the command finishes, noti triggers a notification.

Synopsis: noti [flags] [utility [args...]]

If you do not explicitly specify a configuration file using the --file flag, noti searches for noti.yaml in the following locations, in order:

1. ./.noti.yaml (current working directory)
2. $XDG_CONFIG_HOME/noti/noti.yaml

If $XDG_CONFIG_HOME is not set, it defaults to $HOME/.config/noti/noti.yaml.

Use noti to wrap a command. It will execute the command and trigger a notification once the process completes. You can customize the notification title with -t or --title and the message with -m or --message.

noti tar -cjf music.tar.bz2 Music/

If you prefer not to build from source, you can download the latest pre-compiled binaries for macOS or Linux using curl.

# macOS
curl -L $(curl -s https://api.github.com/repos/variadico/noti/releases/latest | awk '/browser_download_url/ { print $2 }' | grep 'darwin-amd64' | sed 's/"//g') | tar -xz

# Linux
curl -L $(curl -s https://api.github.com/repos/variadico/noti/releases/latest | awk '/browser_download_url/ { print $2 }' | grep 'linux-amd64' | sed 's/"//g') | tar -xz

To use Telegram, create a bot using @BotFather via the /newbot command. Use the resulting bot token in your configuration.

Set the following keys:

• telegram.token: Your bot token.
• telegram.chatId: The chat ID to send to.
• telegram.topic: (Optional) The topic ID.

To use Slack, create an OAuth token via the Slack [OAuth Tokens for Testing and Development] page.

Set the following keys in your config:

• slack.token: Your OAuth token.
• slack.channel: The target channel (e.g., #general) or a username (e.g., @jaime).
• slack.username: The name displayed for the notification bot.