diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..b9b14c43211b754057120aac4861b4bcf7eede11
--- /dev/null
+++ b/README.md
@@ -0,0 +1,23 @@
+# Lecture note resources Martin Goik
+
+## Content
+This repository hosts resources for generating lecture notes and exercises to be found at https://freedocs.mi.hdm-stuttgart.de.
+
+![](https://freedocs.mi.hdm-stuttgart.de/webhelp/resources/freedocs.svg)
+
+## Using the beast
+
+Course material generation and installation has been successfully tested on Ubuntu 16.04 and requires the following packages / executables to be present on your system:
+
+* libav-tools providing avconv
+* [Xmlmind](http://www.xmlmind.com/xmleditor)  document editor
+* rsync
+* texlive-latex-base providing pdflatex
+* imagemagick providing convert
+* transfig providing fig2dev and fig2mpdf 
+* fig2ps providing fig2pdf 
+* pdf2svg 
+* poppler-utils providing pdftoppm
+* [Oracle JDK 1.8](http://www.oracle.com/technetwork/java/javase/downloads)  
+* Scripts from bin subfolder figspecial2pdf, figspecial2png and figspecial2svg 
+ 
\ No newline at end of file
diff --git a/Readme.txt b/Readme.txt
deleted file mode 100644
index a9a63d80ac018354581af9e18d3deed1b9985fbe..0000000000000000000000000000000000000000
--- a/Readme.txt
+++ /dev/null
@@ -1,17 +0,0 @@
-Required packages:
-
-libav-tools (avconv)
-Goik's xmlmind version
- 
-Konversionen:
-ffmpeg -i out.ogv -s 1200x600 -vcodec libx264  -acodec libmp3lame -ab 192k -ac 2 -ar 44100 -f mp4 out.mp4
-ffmpeg -i dataInsert.ogv -acodec libfaac -ab 128k -ac 2 -vcodec libx264 -vpre slow -crf 22 -threads 0 dataInsert.mp4
-
-ffmpeg -i out.ogv -vcodec mpeg4 -sameq -acodec libmp3lame out.avi
-ffmpeg2theora -o q.ogv q.mp4
-
-
-mysql -h goiki  -u  hdmuser -pXYZ
-http://www.htmlgoodies.com/html5/client/how-to-embed-video-using-html5.html
-
-GIT?