📦 telegram-owl — Telegram CLI for Scripts, Alerts, and CI/CD

Send Telegram messages from bash, PowerShell, CI/CD pipelines, cron jobs — quickly and effortlessly.

What is telegram-owl?

telegram-owl is a cross-platform CLI tool written in Go that allows you to send messages, files, and media to Telegram chats, groups, or channels directly from the terminal.

It's perfect for:

✅ DevOps notifications

✅ CI/CD pipeline messages

✅ Monitoring and alerting (cron, systemd, Prometheus)

✅ Just sending a log or file to Telegram from a script

Quick Example

telegram-owl \
  --token=123:abc \
  --chat=@mychannel \
  --message="✅ Deployment completed successfully!"

Send a message from stdin:

echo "🔥 Server is down!" | telegram-owl --stdin --token=... --chat=...

Attach files:

telegram-owl --attach=log.txt --attach=report.pdf --token=... --chat=...

Key Features

Supports Markdown / HTML formatting (--format)
File and media attachments (--attach)
Thread/topic support for supergroups (--thread)
Silent messages (--silent)
Protected content (--protect)
Spoiler effect for media (--spoiler)
Accepts messages from stdin
Cross-platform: Linux, Windows, macOS

Installation

🛠 Supported install methods:

download from GitHub Releases:
https://github.com/beeyev/telegram-owl/releases

Getting Started

🔑 Get a bot token via @BotFather

🔍 Get the Chat ID using /getUpdates or by copying a message link from Telegram

Full guide here:

📖 https://github.com/beeyev/telegram-owl/blob/master/docs/HowToTelegramBot.md

Usage Examples

Send a formatted Markdown message:

telegram-owl --message="*Bold* _Italic_" --format=markdown ...

Where is it useful?

Deployment scripts
Jenkins, GitHub Actions, GitLab CI
Monitoring tools (Prometheus Alertmanager, systemd)
Cron jobs
Backups, automation, and server notifications

📬 Final Thoughts

telegram-owl is a simple way to integrate Telegram into your notification system. No dependencies, cross-platform, and fast.

View the project on GitHub →

DEV Community