diff --git a/README.md b/README.md
new file mode 100644
index 0000000..99addac
--- /dev/null
+++ b/README.md
@@ -0,0 +1,8 @@
+# pixclient - A golang Pixelflut client library
+
+This library implements basic (inperformant) API calls, for sending single pixels, whole images via "PX" and "SIZE" commands.
+
+Currently, it only writes stuff once. Possible further improvements:
+ - Cache PX commands and resend them
+ - When that is done, chunk the image, and send with one thread per chunk.
+ - When that is done, implement filtering, so that old PX commands are overridden by new ones.