telegram-cli man page

telegram-cli — Command-line interface for Telegram messenger

Description

telegram-cli -k <public-server-key>

By default, the public key is stored in etc/telegram-cli/server.pub
Remember to put your international area code before the phone number:

{areacode}{cellphonenumber}

e.g. for Italy: +391234567890

Telegram messenger is a cloud-based instant messaging designed for
smart phones and similar to Whatsapp but more flexible, and
powerful. You can send messages, photos, videos and documents to
people who are in your phone contacts (and have Telegram). Telegram
also supports secret chats whose provide a private (encrypted) way of
communication.

This package contains a command-line based client for Telegram with the following features:

* Colored terminal messages.
* Message management: history, stats, etc.
* Group chat: create and manage groups.
* Secret chat: secured and encrypted conversations.
* Contact management: add/edit/remove contacts.
* Multimedia support: send/load photos and videos.

Supported commands

* Messaging

msg <peer> Text - Sends message to this peer
fwd <user> <msg-seqno> - Forward message to user. You can see message numbers starting client with -N
chat_with_peer <peer> - Starts one on one chat session with this peer. exit or quit to end this mode
add_contact <phone-number> <first-name> <last-name> - Tries to add contact to contact-list by phone
rename_contact <user> <first-name> <last-name> - Tries to rename contact. If you have another device it will be a fight
mark_read <peer> - Mark read all received messages with peer
delete_msg <msg-seqno> - Deletes message (not completly, though)
restore_msg <msg-seqno> - Restores delete message. Impossible for secret chats. Only possible short time (one hour, I think) after deletion

* Multimedia

send_photo <peer> <photo-file-name> - Sends photo to peer
send_video <peer> <video-file-name> - Sends video to peer
send_text <peer> <text-file-name> - Sends text file as plain messages
load_photo/load_video/load_video_thumb/load_audio/load_document/load_document_thumb <msg-seqno> - Loads photo/video/audio/document to download dir
view_photo/view_video/view_video_thumb/view_audio/view_document/view_document_thumb <msg-seqno> - Loads photo/video to download dir and starts system default viewer
fwd_media <msg-seqno> - Send media in your message. Use this to prevent sharing info about author of media (though, it is possible to determine user_id from media itself, it is not possible get access_hash of this user)
set_profile_photo <photo-file-name> - Sets userpic. Photo should be square, or server will cut biggest central square part

* Group chat options

chat_info <chat> - Prints info about chat
chat_add_user <chat> <user> - Add user to chat
chat_del_user <chat> <user> - Remove user from chat
rename_chat <chat> <new-name>
create_group_chat <chat topic> <user1> <user2> <user3> ... - Creates a groupchat with users, use chat_add_user to add more users
chat_set_photo <chat> <photo-file-name> - Sets group chat photo. Same limits as for profile photos.

* Search

search <peer> pattern - Searches pattern in messages with peer
global_search pattern - Searches pattern in all messages

* Secret chat

create_secret_chat <user> - Creates secret chat with this user
visualize_key <secret_chat> - Prints visualization of encryption key. You should compare it to your partner's one
set_ttl <secret_chat> <ttl> - Sets ttl to secret chat. Though client does ignore it, client on other end can make use of it
accept_secret_chat <secret_chat> - Manually accept secret chat (only useful when starting with -E key)

* Stats and various info

user_info <user> - Prints info about user
history <peer> [limit] - Prints history (and marks it as read). Default limit = 40
dialog_list - Prints info about your dialogs
contact_list - Prints info about users in your contact list
suggested_contacts - Print info about contacts, you have max common friends
stats - Just for debugging
show_license - Prints contents of GPLv2
help - Prints this help get_self - Get our user info

* Card

export_card - Print your 'card' that anyone can later use to import your contact
import_card <card> - Gets user by card. You can write messages to him after that

* Other

quit - Quit
safe_quit - Wait for all queries to end then quit

Options

telegram-cli Usage

--phone
/-u Specify username (would not be asked during authorization)
--rsa-key/-k
Specify location of public key (possible multiple entries)
--verbosity/-v
Increase verbosity (0-ERROR 1-WARNIN 2-NOTICE 3+-DEBUG-levels)
--enable-msg-id/-N
Message num mode
--config/-c
Config file name
--profile/-p
Use specified profile
--log-level/-l
Log level
--sync-from-start/-f
During authorization fetch all messages since registration
--disable-auto-accept/-E
disable auto accept of encrypted chats
--lua-script/-s
Lua script file
--wait-dialog-list/-W
Send dialog_list query and wait for answer before reading input
--disable-colors/-C
Disable color output
--disable-readline/-R
Disable readline
--alert/-A
Enable bell notifications
--daemonize/-d
Daemon mode
--logname/-L <log-name>
Log file name
--username/-U <user-name>
Change uid after start
--groupname/-G <group-name>
Change gid after start
--disable-output/-D
Disable output
--tcp-port/-P <port>
Port to listen for input commands
--udp-socket/-S <socket-name>
Unix socket to create
--exec/-e <commands>
Make commands end exit
--disable-names/-I
Use user and chat IDs in updates instead of names
--enable-ipv6/-6
Use ipv6 (may be unstable)
--help/-h
Prints this help
--accept-any-tcp
Accepts tcp connections from any src (only loopback by default)
--disable-link-preview
Disables server-side previews to links
--bot/-b
Bot mode
--json
Prints answers and values in json format

Files

/usr/bin/generate
/usr/bin/telegram-cli
/usr/bin/tl-parser

* Python2 bindings

/usr/bin/generate-2 -> /usr/bin/python2.7-generate
/usr/bin/generate-2.7 -> /usr/bin/python2.7-generate
/usr/bin/telegram-cli-2.7 -> /usr/bin/python2.7-telegram-cli
/usr/bin/telegram-cli-2 -> /usr/bin/python2.7-telegram-cli
/usr/bin/tl-parser-2 -> /usr/bin/python2.7-tl-parser
/usr/bin/tl-parser-2.7 -> /usr/bin/python2.7-tl-parser
/usr/bin/python2.7-tl-parser
/usr/bin/python2.7-telegram-cli
/usr/bin/python2.7-generate

* Python3 bindings

/usr/bin/generate-3 -> /usr/bin/python3.x-generate
/usr/bin/generate-3.x -> /usr/bin/python3.x-generate
/usr/bin/telegram-cli-3.x -> /usr/bin/python3.x-telegram-cli
/usr/bin/telegram-cli-3 -> /usr/bin/python3.x-telegram-cli
/usr/bin/tl-parser-3 -> /usr/bin/python3.x-tl-parser
/usr/bin/tl-parser-3.x -> /usr/bin/python3.x-tl-parser
/usr/bin/python3.x-tl-parser
/usr/bin/python3.x-telegram-cli
/usr/bin/python3.x-generate

Version

1.3.3

See Also

How to contact maintainers: https://github.com/vysheng/tg#contacts

Bugs

Bug tracker: https://github.com/vysheng/tg/issues

Author

Vitaliy Vatman (-@-)

Info

November 2015 telegram-cli 1.3.3 User Commands