diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4f71c69
--- /dev/null
+++ b/README.md
@@ -0,0 +1,39 @@
+lauscher
+========
+
+🚧 **work in progress**: hardcoded config etc. 🚧
+
+* `silence.sh` runs ffmpeg's silencedetect on unprocessed recordings
+* `silence-report.py` parses the files generated by `silence.sh` and prints out a report as a CSV
+
+lauscher deals with some idiosyncracies of ffmpeg's silencedetect like CR characters and that the silence detection does not report an end of the silence if the file ends before the silence ends.
+
+Example output:
+~~~
+$ ./silence-report.py
+2021-10-05 22:00:00;2021-10-05 22:02:36;156
+2021-10-08 01:23:16;2021-10-08 02:00:00;2204
+2021-10-08 01:59:59;2021-10-08 03:00:00;3600
+2021-10-08 02:59:59;2021-10-08 04:00:00;3600
+2021-10-08 03:59:59;2021-10-08 05:00:00;3600
+2021-10-08 04:59:59;2021-10-08 06:00:00;3600
+2021-10-08 05:59:59;2021-10-08 06:29:50;1790
+2021-10-09 00:06:19;2021-10-09 00:07:19;60
+2021-10-10 00:05:15;2021-10-10 00:07:33;137
+2021-10-11 16:45:12;2021-10-11 16:47:46;155
+2021-10-11 23:26:07;2021-10-11 23:26:47;40
+2021-10-14 17:25:20;2021-10-14 17:25:53;33
+2021-10-16 11:25:54;2021-10-16 11:26:26;33
+2021-10-25 17:25:01;2021-10-25 17:48:42;1421
+2021-10-25 17:49:01;2021-10-25 17:49:31;30
+2021-10-25 18:32:06;2021-10-25 18:36:07;241
+2021-10-27 22:00:00;2021-10-27 22:54:28;3268
+2021-10-28 17:38:00;2021-10-28 17:39:10;71
+2021-10-28 17:43:32;2021-10-28 17:45:54;142
+2021-11-02 18:35:22;2021-11-02 18:54:58;1176
+2021-11-04 11:26:12;2021-11-04 11:26:52;40
+2021-11-07 06:59:59;2021-11-07 08:00:00;3600
+2021-11-08 21:59:27;2021-11-08 21:59:59;32
+2021-11-14 06:59:59;2021-11-14 08:00:00;3600
+2021-11-17 22:00:19;2021-11-17 22:01:11;52
+~~~
\ No newline at end of file