mcpField
D
download-media

download-media

github.com/terrylicaProductivity175 installsUpdated today
Repository

About download-media

A skill for downloading photos, videos, documents, and other media from Telegram messages. It guides users through locating a message with media and saving its file using the Telegram CLI.

Key features

  1. 01Browse messages for media
  2. 02Download media by message ID
  3. 03Choose an output directory
  4. 04Troubleshoot missing messages or media
  5. 05Update instructions after reproducible issues

Use cases

  1. 01Saving a photo from a Telegram chat
  2. 02Downloading a document by message ID
  3. 03Finding media in recent messages

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/terrylica/cc-skills --skill download-media

After installing, type/download-mediain Claude Code to confirm it loaded.

Details

From the project README

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

  1. Session must exist: ~/.local/share/gramjs/<profile>.session
    • If missing, run /tlg:setup first

Usage

/usr/bin/env bash << 'EOF'
ROOT="$(cc-plugin-root tlg)"
SCRIPT="$ROOT/scripts/tg-cli.ts"

# Step 1: Find message ID with media
bun "$SCRIPT" read <chat> -n 10

# Step 2: Download by message ID
bun "$SCRIPT" download <chat> <message_id>

# Download to specific directory
bun "$SCRIPT" download 2124832490 471931 -o ./downloads
EOF

Parameters

ParameterTypeDescription
chatstring/intChat containing the message
message_idintID of message with media
-o/--outputpathOutput directory (default: current)

Workflow

  1. Use read <chat> -n N to browse messages and find IDs
  2. Messages with media show [media/service] in text
  3. Use download <chat> <id> to save the file

Error Handling

ErrorCauseFix
message not foundInvalid message IDCheck with read first
has no mediaText-only messageChoose a message with media

Post-Execution Reflection

After this skill completes, check before closing:

  1. Did the command succeed? — If not, fix the instruction or error table that caused the failure.
  2. Did parameters or output change? — If tg-cli.ts's interface drifted, update Usage examples and Parameters table to match.
  3. 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.

Comments

Markdown supported