2 files changed, 20 insertions, 1 deletions

diff --git a/README.md b/README.md
index cb1b7f1..21fc650 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,22 @@
 # hyperspace
 
-TBA
+A screensaver or demoscene, whatever, that opens you up to a new space, hyperspace.
+Made with [Raylib](https://raylib.com) and the C programming language.
+
+![Example](example.gif)
+
+## Compile from sources
+
+```bash
+mkdir build && cd build
+cmake ..
+make
+```
+
+## Customization
+
++ You can replace the star image by placing the `star.png` file along with the executable. 
+
+## License
+
+See [LICENSE](LICENSE). This project is under the WTFPL license.
\ No newline at end of file
diff --git a/example.gif b/example.gif
new file mode 100644
index 0000000..1ba5d7c
--- /dev/null
+++ b/example.gif