From 83b7a1e90ae8ea342faaa1be516f37e901ff552e Mon Sep 17 00:00:00 2001
From: Somdev Sangwan <s0md3v@gmail.com>
Date: Tue, 5 Jan 2021 22:29:00 +0530
Subject: [PATCH] initial docs

---
 README.md | 40 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e35f199
--- /dev/null
+++ b/README.md
@@ -0,0 +1,40 @@
+<h4 align="center">OTE : One Time Email</h4>
+
+<p align="center">
+  <a href="https://github.com/s0md3v/ote/releases">
+    <img src="https://img.shields.io/github/release/s0md3v/ote.svg">
+  </a>
+  <a href="https://github.com/s0md3v/ote/issues?q=is%3Aissue+is%3Aclosed">
+      <img src="https://img.shields.io/github/issues-closed-raw/s0md3v/ote.svg">
+  </a>
+</p>
+
+### Introduction
+**ote** is a command line utility that generates temporary email address and automatically extracts OTPs or confirmation links from the incoming mails. It uses [1secmail.com](https://www.1secmail.com/api/)'s API to generate temporary emails.
+
+It can be install with pip as follows:
+
+```
+pip3 install ote
+```
+
+### Usage
+
+Enter `ote` in your terminal, a random email address will be generated for you. Any OTP or confirmation link sent to this address will be printed on your terminal.
+
+After that:
+- If the link/OTP is not accurate, enter 'f' to print the link to the email to check it yourself.
+- If you want to open the confirmation link in your browser right away, enter 'o' 
+- To quit, either enter 'q' or press Ctrl+C
+
+#### Generate a custom email
+
+`ote init myusername`
+
+It will create an email of form `myusername@domain.com`. After this point, **ote** will use this personalized email every time.
+
+#### Generate a secure email
+
+`ote init`
+
+It will generate a random 20 character email and save it for subsquent usage like the previous option.