diff --git a/Twitch-integration.md b/Twitch-integration.md
new file mode 100644
index 0000000..17e8c6e
--- /dev/null
+++ b/Twitch-integration.md
@@ -0,0 +1,14 @@
+This project supports downloading and monitoring twitch streams from your favorite streamer.
+
+First of all you need to create an app in your [Twitch Developer Console](https://dev.twitch.tv/console/apps/create) and obtain the **client-id** and **client secret**.
+
+In your `config.yml` add the following object:
+
+```yaml
+twitch:
+  client_id: your-client-id
+  client_secret: your-secret
+  check_interval: 2m         # follows standard go Duration format (e.g. 2m30s, 1h, 30s)
+```
+
+After that connect to the web ui and navigate to the Twitch section.