update instructions in README.md

Author: batreller

README.md

@@ -1,12 +1,62 @@
 # AndroidTelePorter
-Converts Android's telegram session into telethon / pyrogram session, also can be used to exctract AuthKey from Android's session
 
-# There are no currently working analogues on the internet.
-##### The software can be used to convert mobile android sessions to any other type of session (pyrogram, telethon, TDATA etc.) or just to extract auth key from the session
+Serializer and deserializer for mobile telegram session
 
-##### To convert the session all you need is just tgnet.dat file from the root directory of your telegram app on the phone, it's located at data/data/org.telegram.messenger.web, it ca be extracted using ADB (Android Debug Bridge)
+## Table of Contents
 
-##### You can download example file just for tests here: https://drive.google.com/file/d/13xy2EQ_F1ScdFQNONqLoWwbY-ltOk8HF/view?usp=sharing
-###### ps. the software will work and will return you the string session and auth key of that session, but as that session is public, it may already be invalid
+- [Project Name](#project-name)
+  - [Table of Contents](#table-of-contents)
+  - [Description](#description)
+  - [Installation](#installation)
+  - [Usage](#usage)
 
-Technically it is a copy of [Telegram's class NativeByteBuffer](https://github.com/DrKLO/Telegram/blob/master/TMessagesProj/jni/tgnet/NativeByteBuffer.cpp)
+## Description
+
+This tool can be used to serialize and deserialize session on original Telegram client for Android phones.
+
+It can extract any information stored in files/tgnet.dat and all needed information from shared_prefs/userconfing.xml
+
+It also can deserialize existing session into object and convert it into other session formats (currently supported tdata, telethon and tgnet)
+
+And you can serialize session manually into mobile tgnet format, all you need is just auth key, datacenter id and user id, it is minimum information needed for almost any session format
+
+## Installation
+
+You can easily set up this package as it is available on pypi by running the following command
+```bash
+pip install AndroidTelePorter
+```
+
+## Usage
+
+#### Converting existing mobile session into other format
+```python
+from AndroidTelePorter import AndroidSession
+
+# both tgnet.dat and userconfing.xml are stored in /data/data/org.telegram.messenger directory
+# if you have more than 1 account you would need to use tgnet.dat from /files/account(account_number)/tgnet.dat
+# and corresponding userconfig.xml file from /shared_prefs/userconfig(account_number).xml
+session = AndroidSession.from_tgnet(
+    tgnet_path=r'files\tgnet.dat',  # contains auth key and dc id
+    userconfig_path=r'shared_prefs\userconfing.xml'  # contains user id
+)
+
+session.to_tgnet('converted/tgnet')  # will create all needed files right in directory that you specified
+# or
+session.to_tdata('converted/pc')  # will create another folder "tdata" inside directory that you specified
+# or
+session.to_telethon('converted/telethon.session')  # must end with .session
+```
+
+#### Creating mobile session from auth key, dc id and user id
+```python
+from AndroidTelePorter import AndroidSession
+
+session = AndroidSession.from_manual(
+    auth_key=bytes.fromhex('hex auth key'),
+    dc_id=0,  # datacenter id (from 1 to 5)
+    user_id=12345678  # telegram user id
+)  # can be used to create any session (tgnet / tdata / telethon) from auth key, dc id and user id
+
+session.to_tgnet('converted/tgnet')  # will create all needed files right in directory that you specified
+```

setup.py

@@ -7,7 +7,7 @@
 with codecs.open(os.path.join(here, "README.md"), encoding="utf-8") as fh:
     long_description = "\n" + fh.read()
 
-VERSION = '1.0.0'
+VERSION = '1.0.1'
 DESCRIPTION = 'Serializer and deserializer for mobile telegram session'
 
 setup(