python-telegram/README.md

50 lines
1.3 KiB
Markdown

# python-telegram
A small python CLI telegram client. Please note that this application was a
"test" and is not intended to be used other than for testing purpose.
The app only retrieve message recived while active and keep them in logs files (./logs/).
## Installation
### libtdjson.so (1.6.6)
The script will look for the telegram library at "./libtdjson.so". You may either
download it from my website (https://ggenois.dev/pub/libtdjson.so (1.6.6, 64bit Fedora Machine))
or build it by folowing those instructions: https://github.com/tdlib/td#building
### API Keys
I do not provide API credentials; you must provide your own.
To get one, create a Telegram App via https://my.telegram.org/apps and then fill "iApiID" (line 14) with your "App api_id" and "sApiHash" (Line 15) with "App api_hash:".
## Usage
While no user is logged in, the app is in "Authentification mode". Once logged in, you get into an interactive console with those commands:
### exit
exit the application without loging out.
### updateChatsList
Actualise Chats List.
### updateMe
Update Personnals informartions
### listChatRoom
List Available chat room(s)
### getKnowUsers
List Known users of this instance.
### join
Join (set active) a chat room by it's index. Use "listChatRoom" to get rooms indexes.
### send
Send a message into the active room.
### logout
Logout then quit the app.