diff --git a/README.md b/README.md
new file mode 100644
index 0000000..83f5c3e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,37 @@
+# Dvvidget 
+Hi! This the widget system that I wrote for my own desktop <br />
+Here is a list of compositors on which it works
+
+-- Hyprland: ✓ <br />
+-- Sway: unknown <br />
+
+### How to build
+You'll need ```gtk4-layer-shell``` as a dependency, 
+and simply running ```cargo build --release``` would do the job.
+
+### Usage
+Use ```-h/--help``` to print help <br />
+Dvvidget supports custom configs and css files,
+you can use ```-c``` or ```--config``` flag to set the path. The default path is ```$HOME/.config/dvvidget/config.toml```
+<br />
+Here is a sample config file:
+```toml
+[general]
+css_path = "absolute/path/to/your/css"
+
+[volume]
+max_vol = 100
+run_cmd = "wpctl"
+
+[volume.window]
+visible_on_start = false
+exclusive = false
+anchor_left = false
+anchor_right = false
+anchor_top = false
+anchor_bottom = true
+margin_left = 0
+margin_right = 0
+margin_top = 0
+margin_bottom = 130
+```