diff --git a/README.md b/README.md
index 302436d..ba8822b 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,33 @@
-# rssrise
-A script for FreshRSS Instances to send notifs to 50+ messenger through Apprise
+## RSSrise - Apprise Notifications for FreshRSS Instances
+
+<img align="left" width="100" height="100" src=""> Stay up to date with your FreshRSS Instance on the go.
+
+<br>
+
+[![Pulls](https://img.shields.io/docker/pulls/driftywinds/rssrise.svg?style=for-the-badge)](https://img.shields.io/docker/pulls/driftywinds/rssrise.svg?style=for-the-badge)
+
+Also available on Docker Hub - [```driftywinds/rssrise:latest```](https://hub.docker.com/repository/docker/driftywinds/rssrise/general)
+
+### How to use: - 
+
+1. Download the ```compose.yml``` and ```.env``` files from the repo [here](https://github.com/driftywinds/rssrise).
+2. Customise the ```.env``` file according to your needs.
+3. Run ```docker compose up -d```.
+
+<br>
+
+You can check logs live with this command: - 
+```
+docker compose logs -f
+```
+### For dev testing: -
+- have python3 installed on your machine
+- clone the repo
+- go into the directory and run these commands: -
+```
+python3 -m venv .venv
+source .venv/bin/activate
+pip install --no-cache-dir -r requirements.txt
+```  
+- configure ```.env``` variables.
+- then run ```python3 main.py```