DEV Community

Mihir
Mihir

Posted on

Telert – Telegram/Slack/Desktop alerts when your terminal commands finish

Hi everyone,

I recently built a small open-source tool called Telert.
It helps you get notifications when your terminal commands or Python scripts finish running — useful when you run long processes and don't want to keep checking the terminal.

I built it for myself initially, but realized it might help others too!

Telert Demo

What Telert Does

  • Works as a command-line utility and a Python hook
  • Sends notifications via Telegram, Slack, Teams, desktop notifications, or audio alerts
  • Customizable messages with status codes (success, failure, etc.)
  • Hooks to auto-notify if a command runs longer than a set time
  • Cross-platform install via pip: Linux, macOS, Windows

Quick Install

Install Telert via pip:

pip install telert
Enter fullscreen mode Exit fullscreen mode

Set up your channels easily:

telert config audio
telert config telegram --token "<token>" --chat-id "<chat-id>" --set-default
Enter fullscreen mode Exit fullscreen mode

Track your long running commands

sleep 5 | telert
Enter fullscreen mode Exit fullscreen mode

You'll get an alert when the command completes!

Example Use Cases

  • Monitor long-running ETL jobs and get notified when they complete
  • Receive Telegram or Slack alerts after server updates, backups, or cronjobs finish
  • Track the completion of machine learning model training or batch predictions
  • Get desktop notifications after code compilation, testing, or Docker builds during development
  • Get notified if any command takes longer than a set time

GitHub Repository

You can check out Telert here:
https://github.com/navig-me/telert

Would love feedback, ideas, or suggestions on how to improve it!
If you find it useful, a GitHub star ⭐ would be appreciated.

Top comments (0)