diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1a8cde6
--- /dev/null
+++ b/README.md
@@ -0,0 +1,37 @@
+# Plymouth-Progress-Bar
+
+Plymouth-Progress-Bar is a Plymoyth theme featuring a progress bar, available in various color schemes. It is based on **[Micheal Bearly's Apple Mac Plymouth Bar](https://www.opencode.net/mikebearly/apple-mac-plymouth)**
+
+# Screenshots
+
+
+
+
+
+
+
+
+
+
+
+
+**[Screenshots folder (including encryption prompt)](https://github.com/1deterministic/Plymouth-Progress-Bar/screenshots)**
+
+# Building
+Just run `build.sh` from the project folder. It will create a folder called `build`, where all color schemes will be available with their own folders.
+To generate screenshots Python 3 with the Pillow module is required. The generation of screenshots is enabled by default, but will only create 1024x768 images. More resolutions are available editing `create-screenshots.py`
+
+# Editing
+* Edit the `.xcf` files in `gimp-sources` with **[GIMP](https://www.gimp.org/)** to your liking.
+* Export them as `.png` without changing the name, you can override existing files in `color-schemes` or create your own folder there.
+* **The build script will only consider as a color scheme a folder inside another folder in `color-schemes`.** So, say you want to create a theme called my-theme. You could create `color-schemes/custom/my-theme`, and it would generate build/my-theme-custom based on it.
+* The build script will also generate screenshots so you can preview your theme without rebooting.
+
+# Installing
+This will vary between distros, but the general rule is:
+* Your `/etc/default/grub` must contain `quiet splash` in `GRUB_CMDLINE_LINUX=`
+* Copy the theme to `/usr/share/plymouth/themes`
+* Edit `/etc/plymouth/plymouth.conf`, changing `Theme=` to match your theme (e.g. `Theme=adwaita-blue-dark`)
+* Regenerate your initramfs as well as your grub.cfg (on Debian/Ubuntu should be `update-initramfs -u` and `update-grub`, both as root)
+
+## [1deterministic](https://github.com/1deterministic), 2019
\ No newline at end of file
diff --git a/screenshots/adwaita-blue-dark/1024x768-encrypted.png b/screenshots/adwaita-blue-dark/1024x768-encrypted.png
new file mode 100644
index 0000000..1927825
Binary files /dev/null and b/screenshots/adwaita-blue-dark/1024x768-encrypted.png differ
diff --git a/screenshots/adwaita-blue-dark/1024x768.png b/screenshots/adwaita-blue-dark/1024x768.png
new file mode 100644
index 0000000..8e3a4cc
Binary files /dev/null and b/screenshots/adwaita-blue-dark/1024x768.png differ
diff --git a/screenshots/adwaita-blue-light/1024x768-encrypted.png b/screenshots/adwaita-blue-light/1024x768-encrypted.png
new file mode 100644
index 0000000..26a99cd
Binary files /dev/null and b/screenshots/adwaita-blue-light/1024x768-encrypted.png differ
diff --git a/screenshots/adwaita-blue-light/1024x768.png b/screenshots/adwaita-blue-light/1024x768.png
new file mode 100644
index 0000000..61704cf
Binary files /dev/null and b/screenshots/adwaita-blue-light/1024x768.png differ
diff --git a/screenshots/arch-linux-branded/1024x768-encrypted.png b/screenshots/arch-linux-branded/1024x768-encrypted.png
new file mode 100644
index 0000000..f93606c
Binary files /dev/null and b/screenshots/arch-linux-branded/1024x768-encrypted.png differ
diff --git a/screenshots/arch-linux-branded/1024x768.png b/screenshots/arch-linux-branded/1024x768.png
new file mode 100644
index 0000000..0feab0f
Binary files /dev/null and b/screenshots/arch-linux-branded/1024x768.png differ
diff --git a/screenshots/breeze-blue-dark/1024x768-encrypted.png b/screenshots/breeze-blue-dark/1024x768-encrypted.png
new file mode 100644
index 0000000..04e1f40
Binary files /dev/null and b/screenshots/breeze-blue-dark/1024x768-encrypted.png differ
diff --git a/screenshots/breeze-blue-dark/1024x768.png b/screenshots/breeze-blue-dark/1024x768.png
new file mode 100644
index 0000000..79b6206
Binary files /dev/null and b/screenshots/breeze-blue-dark/1024x768.png differ
diff --git a/screenshots/breeze-blue-light/1024x768-encrypted.png b/screenshots/breeze-blue-light/1024x768-encrypted.png
new file mode 100644
index 0000000..8e8d4eb
Binary files /dev/null and b/screenshots/breeze-blue-light/1024x768-encrypted.png differ
diff --git a/screenshots/breeze-blue-light/1024x768.png b/screenshots/breeze-blue-light/1024x768.png
new file mode 100644
index 0000000..1a7902f
Binary files /dev/null and b/screenshots/breeze-blue-light/1024x768.png differ
diff --git a/screenshots/debian-branded/1024x768-encrypted.png b/screenshots/debian-branded/1024x768-encrypted.png
new file mode 100644
index 0000000..79ef673
Binary files /dev/null and b/screenshots/debian-branded/1024x768-encrypted.png differ
diff --git a/screenshots/debian-branded/1024x768.png b/screenshots/debian-branded/1024x768.png
new file mode 100644
index 0000000..6ae4173
Binary files /dev/null and b/screenshots/debian-branded/1024x768.png differ
diff --git a/screenshots/fedora-branded/1024x768-encrypted.png b/screenshots/fedora-branded/1024x768-encrypted.png
new file mode 100644
index 0000000..f4408fe
Binary files /dev/null and b/screenshots/fedora-branded/1024x768-encrypted.png differ
diff --git a/screenshots/fedora-branded/1024x768.png b/screenshots/fedora-branded/1024x768.png
new file mode 100644
index 0000000..ab1ed03
Binary files /dev/null and b/screenshots/fedora-branded/1024x768.png differ
diff --git a/screenshots/manjaro-branded/1024x768-encrypted.png b/screenshots/manjaro-branded/1024x768-encrypted.png
new file mode 100644
index 0000000..0b83269
Binary files /dev/null and b/screenshots/manjaro-branded/1024x768-encrypted.png differ
diff --git a/screenshots/manjaro-branded/1024x768.png b/screenshots/manjaro-branded/1024x768.png
new file mode 100644
index 0000000..5efd020
Binary files /dev/null and b/screenshots/manjaro-branded/1024x768.png differ
diff --git a/screenshots/opensuse-branded/1024x768-encrypted.png b/screenshots/opensuse-branded/1024x768-encrypted.png
new file mode 100644
index 0000000..30ac2fd
Binary files /dev/null and b/screenshots/opensuse-branded/1024x768-encrypted.png differ
diff --git a/screenshots/opensuse-branded/1024x768.png b/screenshots/opensuse-branded/1024x768.png
new file mode 100644
index 0000000..6fa198e
Binary files /dev/null and b/screenshots/opensuse-branded/1024x768.png differ
diff --git a/screenshots/steam-os-branded/1024x768-encrypted.png b/screenshots/steam-os-branded/1024x768-encrypted.png
new file mode 100644
index 0000000..64aae97
Binary files /dev/null and b/screenshots/steam-os-branded/1024x768-encrypted.png differ
diff --git a/screenshots/steam-os-branded/1024x768.png b/screenshots/steam-os-branded/1024x768.png
new file mode 100644
index 0000000..5bcfcec
Binary files /dev/null and b/screenshots/steam-os-branded/1024x768.png differ
diff --git a/screenshots/ubuntu-branded/1024x768-encrypted.png b/screenshots/ubuntu-branded/1024x768-encrypted.png
new file mode 100644
index 0000000..0131cad
Binary files /dev/null and b/screenshots/ubuntu-branded/1024x768-encrypted.png differ
diff --git a/screenshots/ubuntu-branded/1024x768.png b/screenshots/ubuntu-branded/1024x768.png
new file mode 100644
index 0000000..3a054f5
Binary files /dev/null and b/screenshots/ubuntu-branded/1024x768.png differ