/ тг

Интерфейс командной строки Telegram messenger

Интерфейс командной строки для Telegram. Использует интерфейс readline.

API, документация по протоколу

Документация для Telegram API доступна здесь: http://core.telegram.org/api

Документация по протоколу MTproto доступна здесь: http://core.telegram.org/mtproto

Обновление до версии 1.0

Прежде всего, двоичный файл теперь находится в папке ./bin и называется telegram-cli. Так что будьте осторожны, не используйте старый двоичный файл.

Во-вторых, папка конфигурации теперь $ {HOME}/. Telegram-cli

В-третьих, база данных несовместима с более старые версии, поэтому вам придется снова войти в систему.

В-четвертых, в peer_name ‘#’ заменяется на ‘@’. (Не применяется к добавлению ‘#% d’ в случае двух одноранговых узлов с одинаковыми именами).

Установка

Клонировать репозиторий GitHub

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

Поддержка Python

Поддержка Python в настоящее время ограничена Python 2.7 или Python 3.1+. Другие версии могут работать, но не протестированы.

Linux и BSD

Установите библиотеки: readline, openssl и (если вы хотите использовать config) libconfig, liblua, python и libjansson. Если вы не хотите их использовать, передайте параметры —disable-libconfig, —disable-liblua, —disable-python и —disable-json соответственно.

В Ubuntu/ Использование Debian:

  sudo apt-get install libreadline-dev libconfig-dev libssl-dev lua5.2 liblua5.2-dev libevent-dev libjansson-dev libpython-dev make  

В 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  

В Fedora:

  sudo dnf  установить lua-devel openssl-devel libconfig-devel readline-devel libevent-devel libjansson-devel python-devel  

В Archlinux:

  yaourt -S telegram-cli-git  

Во FreeBSD:

  pkg install libconfig libexecinfo l  ua52 python  

В OpenBSD:

  pkg_add libconfig libexecinfo lua python  

В openSUSE:

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

Затем

  ./configure make  

Другие способы установки в Linux

В Gentoo: используйте предоставленный ebuild.

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

Mac OS X

Клиент зависит от библиотеки readline и libconfig, которые по умолчанию не включены в OS X. Эти библиотеки необходимо установить вручную.

При использовании Homebrew:

  brew install libconfig readline lua python libevent jansson export CFLAGS = "- I/ usr/local/include -I/usr/local/Cellar/readline/6.3. 8/include "export LDFLAGS =" - L/usr/local/lib -L/usr/local/Cellar/readline/6.3.8/lib "./configure && make  

Спасибо @jfontan за это решение.

При использовании 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  

Установите эти порты:

• devel/libconfig
• devel/libexecinfo
• lang/lua52

Затем соберите:

  env CC = clang CFLAGS = -I/usr/local/include LDFLAGS = -L/usr/local/lib LUA =/usr/local/bin/ lua52 LUA_INCLUDE = -I/usr/local/include/lua52 LUA_LIB = -llua-5.2 ./configure make  

Другой UNIX

Если вы управляете чтобы запустить его в другой UNIX, дайте мне знать.

Контакты

Если вы хотите задать вопрос, можете написать в мою телеграмму или в гитхаб (или и то, и другое). Чтобы связаться со мной через телеграмму, вы должны использовать метод import_card с аргументом 000653bf: 0738ca5d: 5521fbac: 29246815: a27d0cda

Usage

  bin/telegram-  cli -k  

По умолчанию открытый ключ хранится в tg-server.pub в той же папке или в/etc/telegram-cli/ server.pub. Если нет, укажите, где его найти:

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

Поддержка клиентов Завершение TAB и история команд.

Peer относится к имени контакта или диалогового окна и может быть доступен после завершения TAB. Для контактов пользователя имя партнера — Name Lastname со всеми пробелами, замененными на подчеркивания.Для чатов это заголовок со всеми пробелами, замененными на подчеркивания. Для зашифрованных чатов это Имя Фамилия со всеми пробелами, замененными на подчеркивания.

Если два или более пира имеют одинаковое имя, номер добавляется к имя. (например, A_B, A_B # 1, A_B # 2 и т. д.)

Поддерживаемые команды

Обмен сообщениями

• msg Text — отправляет сообщение этому узлу.
• fwd — вперед сообщение пользователю. Вы можете видеть номера сообщений, начиная с -N
• chat_with_peer начинает сеанс чата один на один с этим узлом. /exit или/quit, чтобы выйти из этого режима.
• add_contact — пытается добавить контакт в список контактов по телефону
• rename_contact — пытается переименовать контакт. Если у вас есть другое устройство, это будет драка.
• mark_read — пометить все полученные сообщения как одноранговые
• delete_msg — удаляет сообщение (правда, не полностью)
• restore_msg — восстанавливает удаление сообщение. Невозможно для секретных чатов. Возможно только короткое время (я думаю, один час) после удаления

Мультимедиа

• send_photo — отправляет фото одноранговому узлу.
• send_video — отправляет видео одноранговому узлу
• send_text — отправляет текстовый файл в виде простых сообщений.
• load_photo /load_video/load_video_thumb/load_audio/load_document/load_document_thumb — загружает фото/видео/аудио/документ для загрузки директории
• view_photo /view_video/view_video_thumb/view_audio/view_document/view_document_thumb — загружает фото/видео в каталог для загрузки и запускает программу просмотра по умолчанию.
• fwd_media отправить медиа в своем сообщении. Используйте это, чтобы предотвратить совместное использование информации об авторе медиа (хотя можно определить user_id из самого медиа, невозможно получить access_hash этого пользователя)
• set_profile_photo — устанавливает юзерпик. Фотография должна быть квадратной, иначе сервер обрежет самую большую центральную квадратную часть

Параметры группового чата

• chat_info — выводит информацию о чате
• chat_add_user — добавляет пользователя в чат
• chat_del_user — удалить пользователя из чата
• rename_chat
• create_group_chat … — создает групповой чат с пользователями, используйте chat_add_user, чтобы добавить больше пользователей
• chat_set_photo — устанавливает фото группового чата. Те же ограничения, что и для фотографий профиля.

Search

• search шаблон — шаблон поиска в сообщениях с одноранговым узлом
• global_search шаблон — шаблон поиска во всех сообщениях

Секретный чат

• create_secret_chat — создает секретный чат с этим пользователем.
• visualize_key — выводит визуализацию ключа шифрования. Вы должны сравнить его со своим партнером.
• set_ttl — устанавливает ttl в секретный чат. Хотя клиент игнорирует его, клиент на другом конце может его использовать.
• accept_secret_chat — вручную принять секретный чат (полезно только при запуске с -E key)

Статистика и другая информация

• user_info — выводит информацию о user
• history [limit] — печатает историю (и отмечает ее как прочитанную). Ограничение по умолчанию = 40
• dialog_list — выводит информацию о ваших диалогах.
• contact_list — выводит информация о пользователях в вашем списке контактов
• предложенные_контакты — распечатать информацию о контактах, у вас максимальное количество общих друзей
• статистика — только для отладки.
• show_license — выводит содержимое GPLv2.
• help — выводит справку.
• get_self — получать информацию о нашем пользователе

Card

• export_card — распечатайте свою ‘карточку’, которую каждый может позже использовать для импорта вашего контакта.
• import_card — получить пользователя по карте. После этого вы можете писать ему сообщения.

Other

• quit — quit
• safe_quit — дождаться завершения всех запросов и выйти.