diff --git a/README.md b/README.md
new file mode 100644
index 0000000..374b556
--- /dev/null
+++ b/README.md
@@ -0,0 +1,84 @@
+# Komplex Wallpaper Engine
+
+Komplex Wallpaper Engine is an advanced wallpaper engine for the KDE Plasma 6 Desktop Environment that allows the use of complex shader arrangements as a Wallpaper. Shader arrangements are a collection of shaders and various channel buffers that the shader is intended to manipulate, resulting in visually stunning live motion and reactive wallpapers.
+
+## Supported Engine Modes
+- ShaderToy
+- Komplex
+
+### Supported Channel Buffers
+- Shaders*
+- Images
+- Videos
+- Cubemaps**
+
+*Shaders must be compiled with the `qsb` tool supplied with Qt. It may be available through your distribution's package manager. Follow the instructions in /tools/README.md to compile shaders for use with Qt.
+
+### Engine Mode: ShaderToy
+
+The [ShaderToy](http://www.shadertoy.com) Engine mode is designed to work with most* of the pages on [ShaderToy.com](http://www.shadertoy.com) and is the easiest to use and configure as it can be setup via the settings panel. Simply select a manipulative shader as the main output and setup the iChannels the shader supports. Try feeding it a generative shader!
+
+*Volumetric and audio channels are not currently supported, but are in development.
+
+ShaderToy import functionality is currently in development
+
+### Engine Mode: Komplex
+
+The **Komplex** engine mode allows for a much more complex wallpaper experience. Instead of a simple configuration scheme, the Komplex engine mode uses a shader pack file that can contain it's own images, cubemaps, videos and shaders. This shader pack must contain a pack.json file that describes the output shader, resolution, speed and channel buffers 0-3. Each channel buffer can have channel buffers 0-3, which can in-turn have channel buffers 0-3 and so on. This allows near infinite arrangement complexity, only limited by hardware and reasoning.
+
+Example `pack.json` file:
+```json
+{
+    "author": "DigitalArtifex",
+    "name": "Test",
+    "version": "1.0.0",
+    "description": "Test",
+    "license": "GPLv3+",
+    "engine": "shadertoys",
+    "id": "sdE3sx",
+
+    "type": 2,
+    "source": "./shaders/video-glitch-extra.frag.qsb",
+    "speed": 0.14,
+
+    "channel0":
+    {
+        "type": 2,
+        "source": "./shaders/edge-detect-greyscale.frag.qsb",
+
+        "resolution_x": 1920,
+        "resolution_y": 1080,
+        "resolution_scale": 1.0,
+        "time_scale": 1.0,
+        "mouse_scale": 1.0,
+
+        "channel0":
+        {
+            "type": 2,
+            "source": "./shaders/Glow-City.frag.qsb",
+
+            "resolution_x": 1920,
+            "resolution_y": 1080,
+            "resolution_scale": 1.0,
+            "time_scale": 1.0,
+            "mouse_scale": 1.0
+        }
+    }
+}
+```
+
+## Installation (manual)
+
+Contents of the `data` directory should be placed in `~/.local/komplex/`
+
+Compiling requires setting up the `kde-builder` package, setting the required env variables and selecting the proper CMake kit for building.
+
+## Installation (Release Packages)
+
+No release packages are available at this time. We are working on getting them setup for multiple package managers.
+
+## Credits
+
+This project was inspired by `KDE Shader Wallpaper`, `Wallpaper Engine` and others. It uses code that was originally part of `KDE Shader Wallpaper`.
+
+This project uses icons donated by [Icons8](http://www.icons8.com)
\ No newline at end of file
diff --git a/REAME.md b/REAME.md
deleted file mode 100644
index e69de29..0000000