diff --git a/README.md b/README.md
new file mode 100644
index 0000000..40023cc
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+# RayRecord
+
+exemple of recording the screen with raylib and ffmpeg
+
+# how it work
+
+1. draw stuff using raylib
+2. capture frame buffer
+3. pipe it to ffmpeg
+
+# bug
+
+If the FPS is to high you might have some frame swapped and one black frame at the begining.
+
+It seems to be from raylib or from my machine because I have the same result if I take screenshot with raylib's `TakeScreenshot()` or if I save the frame buffer with `stbi_image_write.h`.
+
+FIX: lower the fps with `SetTargetFPS(10)`