diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8ac792a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,80 @@
+# Dotfiles
+
+Welcome to my personal dotfiles repository! Simply put, this is a complete collection of my system configuration files,
+mostly just here for my personal use, but of course, you're free to take anything you like (as long as you follow the
+license).
+
+## Images
+
+What everyone is here for!
+
+**My WM and EWW bar**
+https://user-images.githubusercontent.com/20902250/202879948-f5d79f70-72ff-4cae-97aa-da9a863ac688.mp4
+
+**Prompt timing showcase**
+![image](https://user-images.githubusercontent.com/20902250/202880140-78dc3f65-ea5d-4155-819b-39bd30d2b31e.png)
+
+**Terminal color scheme showcase**
+![image](https://user-images.githubusercontent.com/20902250/117699472-69ab5d80-b1b4-11eb-85a8-2b039bc1599a.png)
+
+**Unknown command package handler**
+![image](https://user-images.githubusercontent.com/20902250/202880240-c5f975cb-bedb-459b-9a38-fa70a454e0a6.png)
+
+## Features
+
+- Full fledged ZSH configuration without relying on oh-my-zs
+    - oh-my-zsh configuration is also supported, but it is off by default, adjust [`.zshrc`](./home/.config/zsh/.zshrc)
+      to enable it
+    - While you can enable the omz support, it's not at all necessary, as my configuration already handles most of the basic config, and also adds a ton of cool features
+- Fully custom terminal prompt with a lot of neat features, such as CWD shortening, showing git status, seeing how long
+  a command ran for, and showing non-zero exit codes [prompt](./home/.config/shell/prompt)
+- A ton of neat and helpful [aliases](./home/.config/shell/aliases) and [functions](./home/.config/shell/functions)
+  (probably too many for most people, you should adjust these to your needs)
+- Sensible pre-defined environment variables, allowing for
+    - Colorful man pages using `LESS_TERMCAP`, or if `bat` is installed, using it as `MANPAGER` directly
+    - XDG user directory related variables, making programs use the proper directories, avoiding clutter in `$HOME`
+- Tons of handy scripts for automatic common tasks:
+    - [`incremental-backup`](./root/usr/local/bin/incremental-backup): Simple and minimalistic way to utilize rsync for
+      fast and efficient backups (utilizing hard-links), for any directories, or even for the entire system.
+    - [`auto-chroot`](./root/usr/local/bin/auto-chroot): Quick way to chroot into any accesible linux system, without
+      typing the repetetive mount/umount commands. Allows for selecting user and shell to be used.
+    - [`tamper-check`](./root/usr/local/bin/tamper-check): Script that uses checksums to verify that contents of
+      specified system-critical files haven't changed (be aware that they will obviously change if they're updated)
+    - [`gh-notification`](./home/.local/bin/scripts/gui/gh-notification): Script expected to be ran as cron-job every
+      few minutes, checking for new github notifications using github CLI (requies meiji163/gh-notify gh-cli extension)
+      and sending them out as actual desktop notifications.
+    - [`brightness`](./home/.local/bin/scripts/gui/brightness): Script to quickly change the screen brightness
+    - [`setbg`](./home/.local/bin/scripts/gui/setbg): Simple way to pick a background to be used (both for X11 and
+      Wayland)
+    - Tons of other things! The list is just way too long, check the rest yourself! [system
+      scripts](./root/usr/local/bin), [user scripts](./home/.local/bin)
+
+## Installation
+
+Clone this repository anywhere you like
+```bash
+git https://github.com/ItsDrike/dotfiles
+```
+
+If you don't want to use git (running straight from newly installed OS), you can even use `curl`:
+```bash
+curl -LJO https://github.com/ItsDrike/dotfiles/tarball/main
+```
+And extract from `.tar.gz` archive with: `tar xvf [archive name]`
+
+## Attribution
+
+The open-source community has an incredible amount of resources that people have freely provided to others and we all
+depend on these projects in many ways. This collection of configuration files is no exception, and while many of the
+scripts and configuration files are my own, many others were partially, or even fully taken from other open-sourced
+repositories like this.
+
+For that reason, we'd like to thank all of these communities and projects for keeping their content open and available
+to everyone, but most notably we'd like to thank and reference the significant projects that allowed this repository to
+be as amazing as it is now:
+
+- [Luke Smith's dotfiles/voidrice](https://github.com/LukeSmithxyz/voidrice)
+- [Brodie Robertson's dotfiles](https://github.com/BrodieRobertson/dotfiles)
+- [Brodie Robertson's scripts](https://github.com/BrodieRobertson/scripts)
+- [Derek Taylor's dotfiles](https://gitlab.com/dwt1/dotfiles)
+- [Mihai Fufezan's dotfiles](https://github.com/fufexan/dotfiles)