Send Clipboard to Telegram Instantly
A fast, lightweight, cross-platform Python CLI that delivers your clipboard directly to Telegram.
Everything you need, nothing you don't
tgclip is built to disappear into your workflow — one command, zero friction.
One command, instant delivery
Copy something, run tgclip send, and it's in your Telegram chat in under a second.
Cross-platform support
Runs the same on Linux, macOS, and Windows — no platform-specific setup.
Secure local configuration
Your bot token and chat ID stay on your machine, stored locally — never uploaded anywhere.
Beautiful terminal experience
Rich colors, clear feedback, and helpful errors make every run pleasant to watch.
Lightweight by design
A minimal footprint and near-instant startup — it feels like part of your shell.
Open source, MIT licensed
Free to use, fork, and modify. Built in public, improved by its community.
Rich CLI interface
Sensible subcommands, helpful --help text, and clear exit codes throughout.
Simple setup
Run tgclip init, paste your bot token, and you're sending clips in under a minute.
Install in one line
Pick whichever tool manages your Python packages.
$ uv tool install tgclip
$ pip install tgclip
Three commands to your first clip
Set up tgclip once, launch the dashboard, and explore ecery command with ease.
Command reference
Everything tgclip can do, in one table.
| Command | Description |
|---|---|
| init | Set up tgclip — connect your Telegram bot token. |
| tgclip | Launches the tgclip interactive dashboard. |
| send | Send the current clipboard content to Telegram right now. |
| watch | Monitor the clipboard continuously and send new content as it's copied. |
| shell | start an intractive shell to send multiple messages. |
| doctor | Diagnose your setup — checks config, connectivity, and clipboard access. |
| reset | Clear your saved configuration and start fresh. |
| --help | Show usage, available commands, and flags. |
From your clipboard to your chat
Four steps, no server in between.
Clipboard
you copy text
tgclip
reads & forwards
Bot API
Telegram delivers it
Telegram Chat
message arrives
What it looks like
A calm, readable terminal — even when things go wrong.