From aa97b3d5d2152404bbbc209a3aaee4d5ac935d4c Mon Sep 17 00:00:00 2001
From: q3aql <q3aql@protonmail.ch>
Date: Sat, 3 Apr 2021 18:52:01 +0200
Subject: [PATCH] README.md

---
 README    | 48 -------------------------------
 README.md | 84 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 84 insertions(+), 48 deletions(-)
 delete mode 100644 README
 create mode 100644 README.md

diff --git a/README b/README
deleted file mode 100644
index f60c128..0000000
--- a/README
+++ /dev/null
@@ -1,48 +0,0 @@
-ip2e - Receive your public IP (dynamic) by email when it is renewed
-===================================================================
-
-TOOLS
------
-
-* ip2e-daemon.py: Daemon to control & send by email your public IP.
-* ip2e-log.py: Tool to see the log file when daemon is running.
-* ip2e-config.py: Tool to create a valid configuration file.
-
-HOW TO INSTALL
---------------
-
- * Unix systems (GNU/Linux,*BSD, etc..)
- ======================================
-
-   - Open the terminal and type the following comands:
-   
-     $ git clone https://github.com/q3aql/ip2e.git
-     $ cd ip2e
-     # make
-     
-   Note: You must install git & python3 previously.
-   
- * Mac OS X
- ==========
- 
-   - Open the terminal and type the following comands:
-   
-     $ git clone https://github.com/q3aql/ip2e.git
-     $ cd ip2e
-     # make -f makefile.osx
-     
-   Note: You must install git & python3 previously.
-     
- * Windows
- =========
- 
-   - Install Python 3.x from https://www.python.org/.
-   - Download https://github.com/q3aql/ip2e/archive/master.zip
-   - Unzip the package in your system. For example in C:\Program Files\.
-   - Add the folder to PATH variable.
-   - Double click on 'install.cmd'.
-
-HOW TO USE
------------
-
-   - Read 'How-to-Use.txt".
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..40d62ce
--- /dev/null
+++ b/README.md
@@ -0,0 +1,84 @@
+ip2e - Receive your public IP (dynamic) by email when it is renewed.
+====================================================================
+
+### Tools:
+  
+  * [ip2e-daemon.py](https://github.com/q3aql/ip2e/blob/master/src/ip2e-daemon.py) - Daemon to control & send by email your public IP.
+  * [ip2e-log.py](https://github.com/q3aql/ip2e/blob/master/src/ip2e-log.py) - Tool to see the log file when daemon is running. 
+  * [ip2e-config.py](https://github.com/q3aql/ip2e/blob/master/src/ip2e-config.py) - Tool to create a valid configuration file.
+    
+### Downloads:
+
+  * [ip2e-1.3.2-all.deb](https://github.com/q3aql/ip2e/releases/download/v1.3.2/ip2e-1.3.2-all.deb)
+  * [ip2e-1.3.2-all.rpm](https://github.com/q3aql/ip2e/releases/download/v1.3.2/ip2e-1.3.2-all.rpm)
+  * [ip2e-1.3.2.tar.bz2](https://github.com/q3aql/ip2e/releases/download/v1.3.2/ip2e-1.3.2.tar.bz2)
+  * [ip2e-1.3.2.tar.gz](https://github.com/q3aql/ip2e/releases/download/v1.3.2/ip2e-1.3.2.tar.gz)
+
+_Dependence: `python3`._
+
+### Installation:
+
+  * **Unix systems (GNU/Linux,BSD,etc..):**
+  
+    * Open the terminal and type the following comands:
+    
+      ```shell
+      $ git clone https://github.com/q3aql/ip2e.git`
+      $ cd ip2e
+      $ sudo make install
+      ````
+
+_Note: You must install `git` previously._
+
+  * **Mac OS X:**
+  
+    * Open the terminal and type the following comands:
+    
+      ```shell
+      $ git clone https://github.com/q3aql/ip2e.git`
+      $ cd ip2e
+      $ sudo make -f Makefile.OSX
+      ````
+     
+_Note: You must install `git` previously._
+     
+  * **Windows:**
+ 
+    * Install Python 3.x from https://www.python.org/.
+    * Download `ip2e` from [here](https://github.com/q3aql/ip2e/archive/master.zip)
+    * Unzip the package in your system. For example in `C:\Program Files\`
+    * Double click on `Install.cmd`.
+      
+### How to use:
+
+  * **Create a valid configuration file:**
+  
+    * First, you must create the configuration file needed to run `ip2e` correctly. 
+      To do this, run the tool called `ip2e-config.py`:
+
+      ```shell
+      $ ip2e-config.py
+      ````
+     
+  * **Run the daemon:**
+  
+    * When are configured the necessary data of the email sender & receiver, you can 
+      run the tool called `ip2e-daemon.py`:
+    
+      ```shell
+      $ ip2e-daemon.py
+      ````
+      
+    * When daemon is running you can see the log file running the `ip2e-log.py` tool:
+    
+      ```shell
+      $ ip2e-log.py
+      ````
+      
+### Images (Screenshots):
+
+<img src="https://raw.githubusercontent.com/q3aql/ip2e/master/img/ip2e-command.png" width="700" />
+
+### External links:
+
+  * [Python3 homepage](https://www.python.org/downloads/)