GitHub - kenorb-contrib/tg: `telegram-cli` for Telegram IM

Branches Tags

Name		Name	Last commit message	Last commit date
Latest commit History 1,365 Commits
debian		debian
gentoo/net-im/telegram-cli		gentoo/net-im/telegram-cli
parts/plugins		parts/plugins
rpm		rpm
tgl @ 57f1bc4		tgl @ 57f1bc4
.gitignore		.gitignore
.gitmodules		.gitmodules
.travis.yml		.travis.yml
CHANGELOG		CHANGELOG
LICENSE		LICENSE
LICENSE.h		LICENSE.h
Makefile.in		Makefile.in
Makefile.tgl		Makefile.tgl
Makefile.tl-parser		Makefile.tl-parser
README-Cygwin.md		README-Cygwin.md
README-LUA		README-LUA
README-PY.md		README-PY.md
README.es		README.es
README.md		README.md
ax_lua.m4		ax_lua.m4
ax_python.m4		ax_python.m4
bootstrap		bootstrap
compile_osx.sh		compile_osx.sh
config.h.in		config.h.in
config.sample		config.sample
configure		configure
configure.ac		configure.ac
event-old.h		event-old.h
interface.c		interface.c
interface.h		interface.h
json-tg.c		json-tg.c
json-tg.h		json-tg.h
loop.c		loop.c
loop.h		loop.h
lua-tg.c		lua-tg.c
lua-tg.h		lua-tg.h
m4-ax_gcc_builtin.m4		m4-ax_gcc_builtin.m4
m4_ax_check_openssl.m4		m4_ax_check_openssl.m4
m4_ax_check_zlib.m4		m4_ax_check_zlib.m4
main.c		main.c
mime.types		mime.types
python-tg.c		python-tg.c
python-tg.h		python-tg.h
python-types.c		python-types.c
python-types.h		python-types.h
server.pub		server.pub
snapcraft.yaml		snapcraft.yaml
start-telegram-daemon		start-telegram-daemon
telegram-cli-cygwin.patch		telegram-cli-cygwin.patch
telegram-daemon		telegram-daemon
telegram.1		telegram.1
telegram.h		telegram.h
test.lua		test.lua
tg-server.pub		tg-server.pub
tg-test.py		tg-test.py

Repository files navigation

Telegram messenger CLI

Command-line interface for Telegram. Uses readline interface. It is client implementation of TGL library.

Note: This is a fork of telegram-cli.

Build status:

Repository	Status
vysheng (main)
kenorb-contrib

API, Protocol documentation

Documentation for Telegram API is available here: http://core.telegram.org/api

Documentation for MTproto protocol is available here: http://core.telegram.org/mtproto

Upgrading to version 1.0

First of all, the binary is now in ./bin folder and is named telegram-cli. So be careful, not to use old binary.

Second, config folder is now ${HOME}/.telegram-cli

Third, database is not compatible with older versions, so you'll have to login again.

Fourth, in peer_name '#' are substitued to '@'. (Not applied to appending of '#%d' in case of two peers having same name).

Installation

Clone this GitHub repository with --recursive parameter to clone submodules.

 git clone --recursive https://github.com/kenorb-contrib/tg.git && cd tg

< 8000 div class="markdown-heading" dir="auto">

Python Support

Python support is currently limited to Python 2.7 or Python 3.1+. Other versions may work but are not tested.

Linux and BSDs

Install libs: readline, openssl and (if you want to use config) libconfig, liblua, python and libjansson. If you do not want to use them pass options --disable-libconfig, --disable-liblua, --disable-python and --disable-json respectively.

On Ubuntu/Debian use:

 sudo apt-get install libreadline-dev libconfig-dev libssl-dev lua5.2 liblua5.2-dev libevent-dev libjansson-dev libpython-dev libpython3-dev libgcrypt-dev zlib1g-dev lua-lgi make

To build and install the packaege, run:

 dpkg-buildpackage -b
 sudo dpkg -i ../telegram-cli_x.x.x-x_amd64.deb

On Gentoo:

 sudo emerge -av sys-libs/readline dev-libs/libconfig dev-libs/openssl dev-lang/lua dev-libs/libevent dev-libs/jansson dev-lang/python

On Fedora:

 sudo dnf install lua-devel openssl-devel libconfig-devel readline-devel libevent-devel jansson-devel python-devel libgcrypt-devel

On CentOS:

 sudo yum install lua-devel openssl-devel libconfig-devel readline-devel libevent-devel jansson-devel python-devel

On Archlinux:

 yay -S telegram-cli-git

On Milislinux:

 mps kur telegram-cli

On FreeBSD:

 pkg install telegram-cli

On OpenBSD:

 pkg_add libconfig libexecinfo lua python

On openSUSE:

 sudo zypper in lua-devel libconfig-devel readline-devel libevent-devel libjansson-devel python-devel libopenssl-devel

Then,

 ./configure
 make

If you are going to build tg on OpenBSD or FreeBSD, please use gmake instead of make.

Other methods to install on linux

On Gentoo: use ebuild provided.

On Arch: https://aur.archlinux.org/packages/telegram-cli-git

Mac OS X

The client depends on readline library and libconfig, which are not included in OS X by default. You have to install these libraries manually.

If using Homebrew:

 brew tap ivoputzer/tg
 brew install tg

or manually:

 brew install libconfig readline lua python libevent jansson
 export READLINEPATH=$(brew --prefix readline)
 export OPENSSLPATH=$(brew --prefix openssl)
 export CPPFLAGS="-I/usr/local/opt/openssl/include -I$READLINEPATH/include -W"
 export CFLAGS="-I/usr/local/include -I$READLINEPATH/include -I$OPENSSLPATH/include"
 export LDFLAGS="-L/usr/local/lib -L$READLINEPATH/lib -L$OPENSSLPATH/lib"

 ./configure

You might have to manually pass the location of OpenSSL to configure:

$ brew info openssl
openssl: stable 1.0.2e (bottled) [keg-only]
Poured from bottle /usr/local/Cellar/openssl/1.0.2e_1 (465 files, 11.9M)

so in this case the configure should be run as:

 ./configure --with-openssl=/usr/local/Cellar/openssl/1.0.2e_1

in other cases OpenSSL could be found in /usr/local/opt, e.g.:

 ./configure --with-openssl=/usr/local/opt/openssl

If you get a LUA error on Sierra, you can configure without LUA using

 ./configure --disable-liblua

After configuration run build:

make

Thanks to @jfontan for this solution.

If using MacPorts:

 sudo port install libconfig-hr
 sudo port install readline
 sudo port install lua51
 sudo port install python34
 sudo port install libevent
 export CFLAGS="-I/usr/local/include -I/opt/local/include -I/opt/local/include/lua-5.1"
 export LDFLAGS="-L/usr/local/lib -L/opt/local/lib -L/opt/local/lib/lua-5.1"
 ./configure && make

Docker

The set for dockerizing the app: https://github.com/semenyukdmitry/telegram_cli_docker.

Other UNIX

If you manage to launch it on other UNIX, please let me know.

Contacts

If you would like to ask a question, you can write to my telegram or to the github (or both). To contact me via telegram, you should use import_card method with argument 000653bf:0738ca5d:5521fbac:29246815:a27d0cda

Usage

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

By default, the public key is stored in tg-server.pub in the same folder or in /etc/telegram-cli/server.pub. If not, specify where to find it:

bin/telegram-cli -k tg-server.pub

Client support TAB completion and command history.

Peer refers to the name of the contact or dialog and can be accessed by TAB completion. For user contacts peer name is Name Lastname with all spaces changed to underscores. For chats it is it's title with all spaces changed to underscores For encrypted chats it is <Exсlamation mark> Name Lastname with all spaces changed to underscores.

If two or more peers have same name, number is appended to the name. (for example A_B, A_B#1, A_B#2 and so on)

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
send_document <peer> <document-file-name> - sends document to peer
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.

Channels

channel_get_admins <channel> [limit=100] [offset=0] - Gets channel admins
channel_get_members <channel> [limit=100] [offset=0] - Gets channel members
channel_info <channel> - Prints info about channel (id, members, admin, etc.)
channel_invite <channel> <user> - Invites user to channel
channel_join <channel> - Joins to channel
channel_kick <channel> <user> - Kicks user from channel
channel_leave <channel> - Leaves from channel
channel_list [limit=100] [offset=0] - List of last channels
channel_set_about <channel> <about> - Sets channel about info.
channel_set_admin <channel> <admin> <type> - Sets channel admin. 0 - not admin, 1 - moderator, 2 - editor
channel_set_photo <channel> <filename> - Sets channel photo. Photo will be cropped to square
channel_set_username <channel> <username> -Sets channel username info.

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
run telegram-cli -q to logout from account

Troubleshooting

if you got error: get error FAIL: 38: can not parse arg #1 it maybe be unresolved username. You should use resolve_username channel/group/user_name before running action with it. See this issue for more info