diff --git a/assets/display.jpg b/assets/display.jpg
new file mode 100644
index 0000000..9d3780f
Binary files /dev/null and b/assets/display.jpg differ
diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..345c0bf
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,17 @@
+# E-Paper Timetable
+
+A 7 inch display device for loading timetables from untis and displaying them just like on paper.
+
+<img src="assets/display.jpg" height="400px">
+
+## Software
+
+The firmware is written in Rust with ESP-IDF. [epd-waveshare](https://crates.io/crates/epd-waveshare) is used for E-Paper controlling and a custom fork of [untis-rs](https://crates.io/crates/untis) for fetching data from Untis.
+
+## Components
+
+The device consists of an esp32 controller, a 7" E-Paper-Display (and a driver board for it), a battery with charging controller with USB-C port and a 3d-printed casing.
+
+## Goal
+
+I wanted to have a hands-free timetable in my school locker. Just like the good old times when you didn't need your phone to check your timetable. This device uses e-paper to create one of them good ol' paper timetables, except its always up-to-date. I built this for my "Seminararbeit" (a wannabe research paper you have to write in german highschool)
\ No newline at end of file