diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..a5ada33
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,3 @@
+.DS_Store
+.AppleDouble
+.LSOverride
\ No newline at end of file
diff --git a/readme.md b/readme.md
index f845521..ffa0d45 100644
--- a/readme.md
+++ b/readme.md
@@ -1,3 +1,20 @@
-#Again
+# Again
 
-Again, or agn., is a Max package for creating perfectly looping animations and export them as PNG frames, GIFs or WEBM files.
\ No newline at end of file
+![Endless tunnel](./media/tunel.webm)
+
+Again, or agn., is a Max package for creating perfectly looping animations and export them as PNG frames, GIFs or WEBM files.
+
+It consists of three abstrations:
+
+- [agn.host] is the brain of the package. It generates synchronized bangs, triggers rendering and PNG exports.
+- [agn.remote] gives access to current state in various forms (render bang, phase, frame number, render/export flags...)
+- [agn.convert] helps to convert exported PNGs into GIF or WEBM.
+
+## How to install
+1. [Download the .zip](https://git.tflcl.xyz/tfl/again/archive/master.zip) of this repo (or clone it).
+2. Unzip the archive.
+3. Place the `again` folder inside of your Max Packages folder (usually in ~/Documents/Max/Packages)
+
+## How to use
+
+In the Max menu bar, click 'Extra', then 'again'. Click the objects to open their help files, and explore the provided example patchers.
\ No newline at end of file