diff --git a/README.md b/README.md
index 4e70a5a..0afe90a 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,61 @@
-# trackmyd-bot
\ No newline at end of file
+# trackmyd-bot
+
+trackmyd-bot - a telegram bot that locates your devices
+
+## Architecture
+
+**trackmyd-bot** uses the [**trackmyd-api**](https://github.com/frab1t/trackmyd-api) project APIs to get device locations. 
+
+To configure the server, refer to the  [**trackmyd-api**](https://github.com/frab1t/trackmyd-api) repository.
+
+
+In order to use trackmyd-bot, in addiction to the configuration of the trackmyd-api, it’s also necessary to configure [**GPSLogger**](https://github.com/mendhak/gpslogger), an open-source application that allows sending location through HTTP calls.
+
+
+<img src="architecture.png" height="150">
+
+
+## Usage
+
+Before requesting the position to the bot you need to add a new device and configure it.
+
+### Following the basic steps to configure it:
+
+1. **Add a new device.**
+
+    - Send the `/add` command to the bot. You will be prompted to add the device name. 
+
+2. **Configure GPSLogger on Android.**
+
+    - Once confirmed the device name, the bot will return 3 messages:
+            
+        - URL (full-path including the device ID)
+        - HEADER (HTTP header, used for authentication to APIs)
+        - BODY (HTTP body with the parameters that will be automatically evaluated by GPSLogger).
+    
+        Take the values ​​and insert them in the GPSLogger app under "Logging details > Log to custom URL" specifying method http = 'PATCH' 
+
+    - Press "Start Logging" on GPSLogger.
+
+3. **Request the position at the bot**
+
+    Send the `/position` command to the bot and select the device. If the device (with GPSLogger) has sent the information to the API, 2 messages will be returned (one with the location on the map, and one with additional information).
+
+
+## Installation
+
+### Step by step
+
+1. Install **NodeJS** and **NPM**.
+2. Clone this repository.
+3. Install dependencies with `npm install`.
+4. Create a new bot with **BotFather** on Telegram
+5. Enter the **token** generated by BotFather in (app.token) into `config.json`.
+6. Enter your **Telegram ID** in (app.authorizedUsers) into `config.json`.
+7. Configure Basic Authentication in (app.api.headers) into `config.json`.
+8. Start with `npm start`.
+
+
+The bot was created for fun (and learning).
+ 
+ Made with ❤️ by Francesco Esposito ([@frab1t](https://github.com/frab1t))
diff --git a/architecture.png b/architecture.png
new file mode 100644
index 0000000..851d99c
Binary files /dev/null and b/architecture.png differ