Send notifications to your phone/desktop instantly via the fastest cross-platform messenger. Can be used as an email notifications replacement, as a reminder (with cron), and even as a log monitor (see examples/syslog-monitor.sh).
This script does not use notify-send GNU/Linux utility and even does not interact with it. But it uses common syntax for sending notification: nst 'Title' 'Body' vs notify-send 'Title' 'Body'.
- Python 3 and pip3
requestspython module (see below)
Only for user: pip3 install --user requests
System-wide: sudo -H pip3 install requests
- Create your bot via Bot Father and copy token of your bot
- Get your user id via @get_id_bot
- Press "Start" button to give your bot permission to send messages
- Start script:
./notify-send-telegram.py -t YOUR_TOKEN -r USER_ID 'Hello world' - Add system-wide symlink (optional):
sudo ln -s $(pwd)/notify-send-telegram.py /usr/local/bin/nst
You will get 'Hello world' message from your bot. Token and user id will be saved to config file. If you want to override them, just add option --save.
- Just message with title and body:
nst 'New message' 'Lorem ipsum' - Message without sound:
nst --silent 'Unimportant event' 'Some description' - Read message body from stdin (pipe):
echo "Test" | nst 'Stdin example' --stdin
usage: nst [options] SUMMARY [BODY]
positional arguments:
SUMMARY Notification title, for example 'New mail'
BODY Text of notification, multi-line supported. If BODY
isn't set, just the SUMMARY is sent
optional arguments:
-h, --help show this help message and exit
-n, --silent send notification with no sound
-r chat_id, --recipient chat_id
telegram chat_id (user_id) to send notification
-t TOKEN, --token TOKEN
set telegram bot token to use
-s, --stdin read notification BODY from stdin
-z, --save save recipient & token to config file and use them as
defaults in future
-w, --raw do not escape HTML tags in body (use with caution)
License: MIT
Made with 💚 by Mike_Went