From telegram-cli
Sends files, photos, videos, voice notes, and documents to Telegram chats via personal account using Python Telethon script from Bash. Useful for automating media sharing in scripts.
npx claudepluginhub terrylica/cc-skillsThis skill is limited to using the following tools:
Send files, photos, videos, voice notes, and documents from your personal Telegram account.
Sends photos, videos, voice notes, documents, and files to Telegram users or chats from local paths via personal account using Telethon script.
Sends messages from personal Telegram accounts via MTProto using Telethon. Supports usernames, chat IDs, or phone numbers with predefined profiles. Use for direct Telegram messaging in workflows.
Sends messages, images, polls, and formatted media to Telegram channels and groups via Bot API. Handles inline keyboards and templates for marketing, announcements, and community posts.
Share bugs, ideas, or general feedback.
Send files, photos, videos, voice notes, and documents from your personal Telegram account.
/usr/bin/env bash << 'EOF'
SCRIPT="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/telegram-cli}/scripts/send.py"
# Send a photo/image (auto-detected)
uv run --python 3.13 "$SCRIPT" send-file @username /path/to/photo.jpg
# Send with caption
uv run --python 3.13 "$SCRIPT" send-file 2124832490 /path/to/image.png -c "Check this out"
# Send as voice note (.ogg recommended)
uv run --python 3.13 "$SCRIPT" send-file @username /path/to/audio.ogg --voice
# Send as round video note
uv run --python 3.13 "$SCRIPT" send-file @username /path/to/clip.mp4 --video-note
# Force send as document (no preview)
uv run --python 3.13 "$SCRIPT" send-file @username /path/to/image.png --document
# Send with specific profile
uv run --python 3.13 "$SCRIPT" -p missterryli send-file @username /path/to/file.pdf
EOF
| Parameter | Type | Description |
|---|---|---|
| recipient | string/int | Username, phone, or chat ID |
| file | path | Local file path |
-c/--caption | string | Caption text |
--voice | flag | Send as voice note |
--video-note | flag | Send as round video |
--document | flag | Force document (no media preview) |
Telethon auto-detects media type by extension. Override with flags.
| Type | Extensions | Notes |
|---|---|---|
| Photo | jpg, png, webp | Compressed by Telegram |
| Video | mp4, mov, avi | Use --document to skip compression |
| Audio | mp3, m4a, flac | Sent as audio player |
| Voice | ogg (opus) | Requires --voice flag |
| Document | pdf, zip, any | Sent as file attachment |