Send files to Telegram contacts from your CLI
Project description
📨 tg-send-cli
Send files to Telegram contacts from your CLI with a pretty TUI.
Features
- Pretty TUI — Colors, progress bars, and unicode symbols
- Fuzzy search — Find contacts by typing part of their name
- Easy install — One command installation
Installation
uv tool install tg-send-cli
Or with pip:
pip install tg-send-cli
Setup
Before first use, you need Telegram API credentials:
- Go to my.telegram.org
- Log in with your phone number
- Create a new application
- Copy your API ID and API Hash
The tool will prompt you for these on first run.
Usage
tgsend photo.jpg # Send a photo
tgsend document.pdf # Send a document
tgsend video.mp4 # Send a video
Contact Selection
- Type to fuzzy search through contacts
- ↑↓ to navigate
- Enter to select
- Esc to cancel
First Run
On first run, you'll be prompted to:
- Enter your Telegram API credentials
- Authenticate with your phone number
Your session is saved locally at ~/.telegram_file_sender/.
License
MIT
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file tg_send_cli-1.0.0.tar.gz.
File metadata
- Download URL: tg_send_cli-1.0.0.tar.gz
- Upload date:
- Size: 30.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.21 {"installer":{"name":"uv","version":"0.9.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f6806f2490f62532fe0f20f62a6f02dd09f9fad96b09f2ab55a1fad148eb05c4
|
|
| MD5 |
1f082f785c9226b6b46987f97ee5c527
|
|
| BLAKE2b-256 |
59f2876d246de59ef99a0520dbbc71ab27ac650512c050a084284b83af716f68
|
File details
Details for the file tg_send_cli-1.0.0-py3-none-any.whl.
File metadata
- Download URL: tg_send_cli-1.0.0-py3-none-any.whl
- Upload date:
- Size: 8.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.21 {"installer":{"name":"uv","version":"0.9.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
da30f22bc54f9dab6757e2a7b0784228eb499928f0edbc1c002102e87b489576
|
|
| MD5 |
2a4564667e61283392c15a2a7cae4735
|
|
| BLAKE2b-256 |
18072c46be8f77462ee61ec38d02b9d51e49fbaf21ffdfd67a3031a43edce203
|
