# Install telegram-send with Homebrew, apt

Command-line tool to send Telegram messages. Version 0.39.2 via Homebrew; verified 2026-07-12. Also installable with debian: sudo apt install telegram-send.

## Install

```sh
sudo av install brew:telegram-send
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install telegram-send
```

  Evidence: local Homebrew formula metadata

### Linux

- Debian apt (92%):

```sh
sudo apt install telegram-send
```

  Evidence: Debian stable package indexes: telegram-send from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

## Package facts

- **Package key:** brew:telegram-send
- **Package manager:** Homebrew
- **Version:** 0.39.2
- **Source summary:** Command-line tool to send Telegram messages
- **Homepage:** <https://pypi.org/project/telegram-send/>
- **Repository:** <https://github.com/rahiel/telegram-send>
- **Last updated:** 2026-07-12T22:48:19-07:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- telegram-send (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 0.39.2
## Project history and usage

telegram-send is a Python command-line tool for sending Telegram messages and files to a user, group, or channel. It became useful to shell users because it turns Telegram into a notification target for scripts, cron, and long-running commands.

### Project history

The rahiel/telegram-send repository was created in April 2016, and PyPI shows early 0.3 and 0.5 releases in May 2016. The early project description already framed it as a command-line tool to send messages and files over Telegram from other programs.

The current README and PyPI page broaden the supported message types and installation paths while keeping the same core idea: configure a bot-backed Telegram destination once, then call `telegram-send` from scripts or pipelines.

### Adoption history

telegram-send reached package-manager users through PyPI, Homebrew, Debian, and Ubuntu packaging. Its PyPI classifiers mark it as production/stable and aimed at developers and desktop users on POSIX and Windows.

The tool's adoption niche is pragmatic rather than platform-scale: it is the small CLI people install when they want shell alerts in Telegram without writing Bot API code.

### How it is used

Official examples include sending strings, stdin, files, images, stickers, video, audio, and locations; configuring accounts, groups, or channels; alerting when shell commands complete; and piping cron output through `telegram-send -g --stdin`.

Package users care about its config-file behavior because the configured bot token and chat state are the durable part. The global `/etc/telegram-send.conf` mode makes it usable from cron jobs and system scripts.

### Why package nerds care

telegram-send is package-nerd significant because it is tiny glue with high leverage: install one executable and a system can notify a human through Telegram from shell, cron, Supervisor, or Python.

Its history is a classic CLI utility arc: a small PyPI project became distro-packaged because the command is easier to standardize than every script reimplementing Telegram Bot API calls.

### Timeline

- 2016: rahiel/telegram-send repository created.
- 2016: PyPI publishes early telegram-send releases, including 0.3 and 0.5.
- 2022: PyPI release history shows continued 0.3x maintenance.
- 2026: telegram-send 0.39.2 is published on PyPI.

### Related projects

- Telegram Bot API is the service API underneath the workflow.
- pipx is recommended in current install docs for isolated Python CLI installation.
- ntfy is mentioned in the README as another notification tool for long-running commands.

### Sources

- <https://github.com/rahiel/telegram-send>
- <https://pypi.org/project/telegram-send/>
- <https://pypi.org/project/telegram-send/0.3/>
- <https://pypi.org/project/telegram-send/0.5/>


## Security Notes

No matching local secret-handling manifest was found for telegram-send. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: /etc/telegram-send.conf

## Credential files

- Unix: /etc/telegram-send.conf, user_config_dir("telegram-send") + ".conf"
## Other Package-Manager Records

- Debian apt - telegram-send - 0.37-3: normalized package name match | Debian stable package indexes: telegram-send from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Send messages and files over Telegram from the command-line | https://github.com/rahiel/telegram-send
- Ubuntu apt - telegram-send - 0.37-2: normalized package name match | Ubuntu 24.04 LTS package indexes: telegram-send from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Send messages and files over Telegram from the command-line | https://github.com/rahiel/telegram-send


## Combined YAML source

View the package source record on GitHub. [combined/telegram-send.yml](https://github.com/mxcl/pkgdb/blob/main/combined/telegram-send.yml)


## Sources

- pkg.so package database
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph