diff --git a/README.md b/README.md
index 5747a33..c51d1e5 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,24 @@
 # tinge
 
-Tinge is a mobile first application for controlling Philips Hue lights on Linux
\ No newline at end of file
+Tinge is a mobile first application for controlling Philips Hue lights on Linux
+
+## Installation
+clone this repository:
+```
+git clone https://code.smolnet.org/micke/tinge
+```
+Run the crude installer:
+```
+cd tinge
+./install.sh
+```
+## Requirements
+Requires a recent Python3 and pip3, most likely python >= 3.7. It is only tested with 3.9 on PostmarketOS on the PinePhone and on Debian Bullseye though.
+
+## Screenshots
+![All Bridge View](https://code.smolnet.org/micke/tinge/raw/branch/master/screenshots/20210506_14h48m15s_grim.png)
+![All Group View](https://code.smolnet.org/micke/tinge/raw/branch/master/screenshots/20210506_14h48m24s_grim.png)
+![Single Group View, with Bed Light Off](https://code.smolnet.org/micke/tinge/raw/branch/master/screenshots/20210506_14h48m30s_grim.png)
+![Single Light Off](https://code.smolnet.org/micke/tinge/raw/branch/master/screenshots/20210506_14h48m34s_grim.png)
+![Single Light On](https://code.smolnet.org/micke/tinge/raw/branch/master/screenshots/20210506_14h48m37s_grim.png)
+![Single Group View, with Bed Light On](https://code.smolnet.org/micke/tinge/raw/branch/master/screenshots/20210506_14h48m48s_grim.png)
\ No newline at end of file