Download Telegram Media
Download photos, videos, documents, and other media from Telegram messages.
Self-Evolving Skill: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.
Preflight
- Session must exist:
~/.local/share/telethon/<profile>.session
- If missing, run /tlg:setup first
Usage
/usr/bin/env bash << 'EOF'
SCRIPT="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/tlg}/scripts/tg-cli.py"
# Step 1: Find message ID with media
uv run --python 3.13 "$SCRIPT" read <chat> -n 10
# Step 2: Download by message ID
uv run --python 3.13 "$SCRIPT" download <chat> <message_id>
# Download to specific directory
uv run --python 3.13 "$SCRIPT" download 2124832490 471931 -o ./downloads
EOFParameters
| Parameter | Type | Description |
|---|---|---|
| chat | string/int | Chat containing the message |
| message_id | int | ID of message with media |
-o/--output | path | Output directory (default: current) |
Workflow
- Use
read <chat> -n Nto browse messages and find IDs - Messages with media show
[media/service]in text - Use
download <chat> <id>to save the file
Error Handling
| Error | Cause | Fix |
|---|---|---|
message not found | Invalid message ID | Check with read first |
has no media | Text-only message | Choose a message with media |
Post-Execution Reflection
After this skill completes, check before closing:
- Did the command succeed? — If not, fix the instruction or error table that caused the failure.
- Did parameters or output change? — If tg-cli.py's interface drifted, update Usage examples and Parameters table to match.
- Was a workaround needed? — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.
Only update if the issue is real and reproducible — not speculative.