Skip to content

About

(GitLab Mirror) Telegram Client for Terminal; Official Git Source at https://gitlab.com/wqyeo/telegram-cli

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Unofficial Telegram CLI

A Java 25 terminal-client project targeting Windows and Linux, with TDLib planned as its Telegram engine. Independent of and not endorsed by Telegram.

Status

Offline prototype—not yet a usable Telegram account client. Includes synthetic Linux terminal UIs, explicit local profile/encrypted-vault tools and an account-free native-worker check. The read-only preview uses public fixtures, not a real account. There is no operational login, TDLib account database, live messaging or account-session reuse. Windows recipes are unverified; native Windows terminal execution is refused.

The G1 native-hardening source checkpoint preserves experimental patches, PUBLIC fixtures and Java lease work. Its guarded factory remains fenced; selected contracts and component checks are not engine-wide acceptance.

The next product milestone is an ordinary-conversation read-only session through authenticated reopen. The activation-blocker register and shared-reader contract proposal define the remaining work; they do not enable a real account client or approve native/account execution.

P1 ordinary-reader plumbing now supports chat selection, loaded-directory search, history pages and incoming updates through the shared PUBLIC in-memory/process fixture API. This is implemented code with no new CLI/TUI entry point; it does not remove the native activation blockers or make account access available.

Build and try

Use a full JDK 25. The Maven Wrapper downloads pinned Maven 3.9.16 and verifies its distribution checksum. No Telegram credentials or native libraries are needed. With mise, run mise trust, mise install, and prefix commands with mise exec -- if the toolchain is not activated in your shell.

./mvnw --batch-mode --no-transfer-progress clean verify
java -jar target/telegram-cli.jar --help
java -jar target/telegram-cli.jar diagnostics --json
java -jar target/telegram-cli.jar demo --json
java -jar target/telegram-cli.jar tui --demo
java -jar target/telegram-cli.jar tui --read-only-demo

The read-only guide advances fixed public inputs with Enter: never type credentials into it. It then shows bounded synthetic chats and Saved Messages text, without a composer or send action. The original demo remains separate.

Keep target/lib/ beside the development JAR: Lanterna and the original Bouncy Castle JAR are separate runtime dependencies; Lanterna remains replaceable. Java 25 is required; self-contained Linux images are built separately. Checks are manual; CI/CD is deferred.

For the optional JNI build and app image, see the wiki's offline prototype guide. On Windows PowerShell use .\mvnw.cmd; Windows execution is not validated by Linux tests.

Documentation

Detailed documentation lives in the GitLab wiki:

License

MIT, copyright (c) 2026 Yeo Wen Qin. Third-party components retain their own licenses; see third-party notices.

About

(GitLab Mirror) Telegram Client for Terminal; Official Git Source at https://gitlab.com/wqyeo/telegram-cli

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages