diff --git a/README.md b/README.md
index 74bb83b..652bb9f 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,31 @@
-# One Dark theme for Midnight Commander
\ No newline at end of file
+# One Dark theme for [Midnight Commander](https://github.com/MidnightCommander/mc)
+
+![mc-onedark](https://raw.githubusercontent.com/DeadNews/mc-onedark/main/preview/Screenshot_20201219_204641.png)
+
+# Theme variants
+
+The mc OneDark theme comes in two flavors, an 8/16 color option (`onedark.ini`) and a 16M color option (`onedark16M.ini`). The 8/16 color version is entirely dependent on having installed the relevant OneDark theme for your terminal too as it uses the color palette fixed by your terminal.
+
+See [Konsole](https://store.kde.org/p/1225908/) color scheme for example.
+
+The 16M color version can be used independently of any terminal color scheme, but requires true color support in the terminal.
+
+# Installation
+
+Copy files from `./skins` to `~/.local/share/mc/skins` \
+Copy files from `./config` to `~/.config/mc/` (optional)
+
+
+# Activating theme
+
+Option 1: edit `~/.config/mc/ini` and add `skin=onedark`: \
+`sed -i 's|\(^skin=\).*$|\1onedark|' ~/.config/mc/ini`
+
+Option 2: choose the skin through the mc UI with: \
+`F9 > Options > Appearance`
+
+Option 3: run mc with specific skin: \
+`mc -S onedark`
+
+Option 4: add `export MC_SKIN=onedark` to the initialization file of your shell (e.g., `~/.bashrc` or `~/.zshrc`): \
+`echo "export MC_SKIN=onedark" >> ~/.zshrc`
\ No newline at end of file
diff --git a/preview/Screenshot_20201219_204630.png b/preview/Screenshot_20201219_204630.png
index 4599651..f51353a 100644
Binary files a/preview/Screenshot_20201219_204630.png and b/preview/Screenshot_20201219_204630.png differ
diff --git a/preview/Screenshot_20201219_204641.png b/preview/Screenshot_20201219_204641.png
index 124be3d..40cc694 100644
Binary files a/preview/Screenshot_20201219_204641.png and b/preview/Screenshot_20201219_204641.png differ
diff --git a/preview/Screenshot_20201219_204746.png b/preview/Screenshot_20201219_204746.png
index 9cda042..0483221 100644
Binary files a/preview/Screenshot_20201219_204746.png and b/preview/Screenshot_20201219_204746.png differ
diff --git a/preview/Screenshot_20201219_204802.png b/preview/Screenshot_20201219_204802.png
index 4c9ef33..9a08594 100644
Binary files a/preview/Screenshot_20201219_204802.png and b/preview/Screenshot_20201219_204802.png differ