shelomentsevd/telegramgo

CLI telegram client written in golang

Telegram messenger CLI

Command-line interface for Telegram. Uses readline interface.

Build

Dependencies

MTProto - library for working with Telegram API

Release

make

Debug

make debug

Commands

Press CTRL-C to input command. Availables commands:

• \me - shows information about current account
• \contacts - shows contacts list
• \umsg - sends message to user with
• \cmsg - sends message to chat with
• \help - shows available commands
• \quit - quit from program

English Documentation

• coming shortly

Note for Russian Speaking users

Библиотека для работы с Telegram API на Go

В отличии от API для создания ботов, Telegram API для мессенджеров почти не имеет актуальных библиотек. Как на других языках, так и на Go.

Если вам надо написать архиватор сообщений из супергрупп и каналов Telegram'a,вы попали в правильное место.

Библиотека

Большая часть кода позаимствована из http://github.com/sdidyk/mtproto .

Отличия:

• последняя версия Telegram API
• автоматическое переподключение к серверу после сброса соединения
• возможность сериализовать данные полученные из Telegram'a в JSON
• исправлены ошибки предыдущей библиотеки

Кодогенерация

Большая часть кода генерируется спомощью простого скрипта на Python, который выполняет трансляцию из TL(о нем ниже) в Go. В дальнейшем, будут генерироваться не только структуры на Go и методы их сериализации/десереализации из бинарного кода, а ещё функции для вызова процедур API. https://github.com/shelomentsevd/mtproto

О Telegram API и проблемах с документацией

Telegram для обмена данными между сервером и клиентом использует RPC протокол, который описывается через TL-схему. Язык TL(Type Language or Time Limit) описывает как данные будут сериализоваться в бинарный код или десериализовываться из него. Например вот так выглядит описание чата из 23-ей версии схемы Telegram API:

chat#6e9c9bc7 id:int title:string photo:ChatPhoto participants_count:int date:int left:Bool version:int = Chat;

В самом начале пакета идет 4 байта безнакового числа, которые служат индетификатором процедуры или объекта, по ним сервер или клиент догадывается что это и какие данные будут следующими. В нашем случае это "6e9c9bc7". Дальше идут поля структуры в том порядке в каком они записаны в TL-схеме. Подробнее о том как работает протокол и сериализация можно прочитать здесь: https://core.telegram.org/mtproto/TL

К сожалению, на core.telegram.org вы не найдете актуальной версии TL-схемы Telegram API и документации к ней, а только описание языка и работы самого протокола.

Язык

• https://core.telegram.org/mtproto/TL - Описание языка TL
• https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/Resources/scheme.tl - самая свежая версия TL-схемы можно найти здесь.

Примеры работы с Telegram API

• https://github.com/telegramdesktop/tdesktop - Десктопный клиент Telegram'a. Язык C++.
• https://github.com/DrKLO/Telegram - Android клиент. Часть кода работы с API написана на С++, часть на Java.
• https://github.com/QtGram/LibQTelegram - QT библиотека для работы с Telegram API. Язык C++.
• https://github.com/sdidyk/mtproto - Отсюда я позаимствовал большую часть кода. Язык Go.
• https://github.com/zerobias/telegram-mtproto - Библиотеки для JavaScript'a.

Contacts

Feel free to ping me in Telegram or drop me email. If you are in Moscow, feel free to invite me for coffee or quick chat in your office ;)))

• Email: [email protected]
• Telegram: @shelomentsevd

License

MIT

telegramgo's Issues

Reconnect bug

@shelomentsevd @Lord-Protector
When reconnection occurs,expamle not work

Vim plugin

Можно ли его подключить к виму как плагин?

Вообще не понятно ниче

тут

telegramgo/main.go

Line 498 in f9049f7

mtproto, err := mtproto.NewMTProto(41994, "269069e15c81241f5670c397941016a2", mtproto.WithAuthFile(os.Getenv("HOME")+"/.telegramgo", false))

я так понимаю должны быть свои id и hash, но про это нигде не сказано. Что за os.Getenv("HOME")+"/.telegramgo какой структуры данный файл? У меня не работает, после попытки авторизации

telegramgo/main.go

Line 514 in f9049f7

err := telegramCLI.Authorization(phonenumber)

возвращается ошибка SESSION_PASSWORD_NEEDED и через какое-то время тележка присылает сообщение

...
Никто не получил доступ к Вашей переписке, потому что входа в аккаунт не произошло. Код был введен верно, но правильный **пароль указан не был.**
...

я так понимаю где-то нужно указать пароль и сейчас это файл telegramgo?

[Feature Request] Custom server for new account

Feature request: when adding a new account, let the user choose the ip/url of the endpoint of the telegram server, that way it will work also on custom servers

Add registration

1. Start telegramgo
2. Input a phone number
3. Check number is it registered or not
4. If number isn't registered: try to register user

Prompt string do not show until ^C combination

After each input I should press ^C to get "User input: " prompt string and if I do not do it - all my input would be just ignored.
It looks like this:

User input: \contacts
        id        mutual    name                              username
        ...
^C
User input:

Also it would be great to add completion for:

• commands (\c => \commands)
• user id's \umsg

\umsg <TAB>
1 - user1
2 - user2
3 - user3
\umsg

Changing user id's input on usernames input would be also cool.

flood wait

after while we get FLOOD_WAIT_X error or auth_key_unregistered error

Getting panic: runtime error: invalid memory address or nil pointer dereference

goroutine 8 [running]:
github.com/shelomentsevd/mtproto.(*Network).Read(0xc420062120, 0x0, 0x0, 0x0, 0x0)
	/usr/local/share/GOPATH/src/github.com/shelomentsevd/mtproto/network.go:220 +0x7a
github.com/shelomentsevd/mtproto.(*MTProto).readRoutine.func2(0xc42008e210, 0xc4200622a0)
	/usr/local/share/GOPATH/src/github.com/shelomentsevd/mtproto/mtproto.go:266 +0x49
created by github.com/shelomentsevd/mtproto.(*MTProto).readRoutine
	/usr/local/share/GOPATH/src/github.com/shelomentsevd/mtproto/mtproto.go:265 +0xef

Problem with Iran's phone numbers

I've tried your work before, seems you have some issues after reconnecting to another datacenter

You can test with my test phone number: [phone]

Here is what I get:
Exiting readRoutine inner routineError making AuthKey: &{%!e(string=Server response error: -404)}

How to send Image

How to send Image?

Handle multiple sessions

Is there way to handle and store sessions of multiple users?