diff --git a/README.md b/README.md
new file mode 100644
index 0000000..fc08146
--- /dev/null
+++ b/README.md
@@ -0,0 +1,11 @@
+# sigstoped
+a user deamon that stops processes associated with background windows
+uses _NET_ACTIVE_WINDOW _NET_WM_PID WM_CLIENT_MACHINE and a blacklist to determine whitch processes to stop via SIGSTOP upon window swtich
+
+usage:
+
+1. build
+2. create ~/.config/sigstoped/blacklist
+  1. one proces name per line, nothing else
+3. run
+