diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3ae1fae
--- /dev/null
+++ b/README.md
@@ -0,0 +1,6 @@
+This is a project to connect to a matrix server, act as a bot, and accept (and make) video calls.
+
+the whole purpose of this is to act as a video intercom for my front door.
+
+It's powered by Matrix, WebRTC, and GStreamer.  While it's not on an active call you can setup a gstreamer
+pipeline to be put into place, in particular one that will just display the camera on screen to act as a video peephole