Telegram MTProto Go CLI

tmgc

A script-first CLI on top of gotd/td. Fast QR login, stable output formats, and keyring-backed sessions with a file fallback.

Get started GitHub

QR login Keyring storage JSON + TSV Profiles

$ tmgc auth config set --api-id 123456 --api-hash abc123...
$ tmgc auth login
$ tmgc chat list --limit 10
$ tmgc message send @username "hello"

Highlights

• QR login with PNG fallback for mobile cameras.
• --json and --plain outputs built for scripts.
• Profiles for multi-account workflows.
• Keyring-first session storage with explicit file fallback.

Install

go install github.com/ghillb/tmgc/cmd/tmgc@latest

Quick start

tmgc auth config set --api-id 123456 --api-hash abc123...
tmgc auth login
tmgc chat list --limit 20
tmgc message send @username "hello"

Need full details? Start at Get Started.