diff --git a/README.md b/README.md
index 7c86606..bd8ccae 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,26 @@
 # RandomVideo
+* shell scripts to play a random video
+* polls big button (buzzer) in left of lounge door
+* polls 2-way-switch left from big button (buzzer)
 
-shell scripts to play a random video
+## files
+### RandomVideo.sh
+* Plays a random video file
+
+### buzzer.sh
+* polls buzzer and 2-way-switch
+
+### onair.mp4
+* placeholder videofile for "On Air"-Message
+
+### userconfig.sh
+* currently not in use
+
+### volumetest.sh
+* testscript for ramping soundcard output volume
+* reads volume value from amixer
+* not a necessary file
+
+## Licence
+* All stuff in this repo is licenced under Unlicence.
+* current onair.mp4 is excluded and a placeholder!