cyberash-dev

cyberash-dev / tg-mtproto-cli

Public

CLI for Telegram via MTProto — chats, messages, media download, multi-account

25
0
100% credibility
Found Feb 24, 2026 at 23 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

A command-line interface for directly accessing Telegram chats, messages, forum topics, and media downloads using the MTProto protocol with multi-account support and secure storage.

How It Works

1
🔍 Discover the tool

You hear about a simple way to view your Telegram chats, messages, and download files directly from your computer screen.

2
💻 Add it to your computer

You easily place this handy program on your computer so it's ready to use anytime.

3
📝 Prepare Telegram access

You visit Telegram's special page to get the permission details needed to connect your account safely.

4
🔐 Sign into your account

You enter your phone number and confirmation code once, and it securely remembers your login for future use.

5
👥 Browse your chats

You see a neat list of all your conversations, groups, and channels with unread counts and recent activity.

6
Dive into details
💬
Read messages

View the latest chats or go back in time to see older ones.

📎
Download files

Save pictures, videos, or documents right to your folder.

🗂️
Explore topics

List and peek into organized discussions in group forums.

🎉 Full access unlocked

Now you can manage multiple accounts, filter by time, and get everything in a simple list or data format effortlessly.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 23 to 25 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is tg-mtproto-cli?

tg-mtproto-cli is a TypeScript CLI telegram client that gives direct MTProto access to Telegram chats, messages, forum topics, and media downloads, bypassing Bot API limits. Install via npm from its GitHub repo, auth with phone number and API keys from my.telegram.org, then run commands like `tg chats`, `tg messages @username --after 09:00`, or `tg download @username 42`. It handles multi-account setups with aliases, secure keychain storage across Linux, Ubuntu, Windows, and JSON output for scripting.

Why is it gaining traction?

Unlike bot-based CLIs, it uses raw MTProto for unlimited message history, time filters, and full media grabs with progress bars—ideal for bulk ops without rate limits. Multi-account switching via `--account` alias, plus JSON piping, hooks scripters tired of web scrapers or partial APIs. Cross-platform keychain creds and Docker-friendly design make it a quick GitHub Actions or Copilot companion for Telegram data pulls.

Who should use this?

DevOps folks automating chats CLI on Linux/Debian/Ubuntu servers, analysts dumping message histories for processing, or multi-account managers downloading media batches. Suits backend devs building telegram cli apps around phone number auth, or GitHub push hooks needing real-time chat monitoring over bots.

Verdict

Grab it if you need raw MTProto power in a lean CLI—solid README and features punch above 18 stars—but 1.0% credibility flags early maturity with no tests visible. Fine for personal scripts; watch for stability before prod.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.