diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..27ce9bf
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,26 @@
+# read me
+
+this is a fuzzy clock that gives time in unequal seasonal named hours. please read the stuff in the file itself, between the bunnies, before using the software. its important important important. 
+
+example output: timetable mode
+
+```
+ 7:46 AM - halo
+ 9:05 AM - steam
+10:24 AM - pang
+11:43 AM - mill
+ 1:02 PM - glean
+ 2:21 PM - gleam
+ 3:40 PM - glance
+ 4:59 PM - gloam
+ 7:05 PM - glow
+ 9:12 PM - glim
+11:19 PM - nill
+ 1:25 AM - dream
+ 3:32 AM - seem
+ 5:39 AM - frost
+ ```
+
+example output: normal mode
+
+`early steam`
\ No newline at end of file