📋 TGCLIP

Instantly send clipboard content or text from your computer to Telegram.

A lightweight CLI that moves text, code, links, and commands from your desktop straight to Telegram — built for developers, students, and anyone who lives between a laptop and a phone.

website: tgclip

Table of Contents

• Features
• Installation
• Prerequisites
• Quick Start
• Commands
• Use Cases
• Privacy
• Troubleshooting
• Requirements
• Issues
• License

⚡ Features

🚀	Simple one-time setup
📋	Send clipboard content instantly
✍️	Send custom text directly from the terminal
👀	Clipboard watch mode
💻	Interactive shell mode
⚙️	Easy configuration management
🩺	Built-in diagnostics with doctor
🔄	Reset configuration anytime
🎨	Clean, colorful terminal UI powered by Rich

📦 Installation

Using uv (Recommended)

uv tool install tgclip 

Using pip

pip install tgclip

Verify it worked:

tgclip

✅ Prerequisites

Requirement	Details
Telegram account	Any personal account
Telegram Bot	Created via @BotFather

🚀 Quick Start

tgclip init

You'll be prompted for:

① Your name
② Telegram Bot Token

💾 Configuration is stored locally on your machine — nothing is uploaded anywhere else.

🛠 Commands

tgclip init — Initialize

Configure TGCLIP for first-time use.

tgclip send — Send

Send the current clipboard content to Telegram.

tgclip watch — Watch

Continuously monitor the clipboard and auto-send anything newly copied. Stop with Ctrl + C.

tgclip shell — Shell

Launch an interactive shell for sending multiple messages without restarting the command. Exit with /exit or Ctrl + C.

tgclip config — Configuration

Display your current configuration.

tgclip doctor — Doctor

Runs a full health check:

• ☑ Configuration
• ☑ Clipboard access
• ☑ Internet connectivity
• ☑ Telegram API access
• ☑ Bot token
• ☑ Chat ID

tgclip reset — Reset

Wipes the current configuration so you can start fresh.

💡 Use Cases

• 🧩 Send code snippets to your phone
• 🔗 Transfer commands between devices
• 📝 Save temporary notes
• 🌐 Share links instantly
• 📤 Move terminal output
• 🔄 Continue work from mobile

🔒 Privacy

TGCLIP talks directly to the Telegram Bot API — nothing else is in the loop.

• ✔ Configuration stays on your local machine
• ✔ No external servers, no telemetry, no middleman

🧰 Troubleshooting

Problem	Fix
Something's not working	tgclip doctor
Need to start over	tgclip reset → tgclip init
Forgot a command	tgclip --help

📋 Requirements

• Python 3.10+
• A Telegram Bot
• An internet connection

🐞 Issues

Found a bug or have a feature request? Please open an issue on Github.

📄 License

Released under the MIT License.

Developed by CyberLeafy

TGCLIP — Fast. Simple. Clipboard to Telegram. 📋➡️📱