diff --git a/.gitmodules b/.gitmodules
new file mode 100644
index 0000000..04032f7
--- /dev/null
+++ b/.gitmodules
@@ -0,0 +1,9 @@
+[submodule "nokia-dumper"]
+ path = nokia-dumper
+ url = https://github.com/stze/Home-Brew_Tool-Nokia.git
+[submodule "splituapp"]
+ path = splituapp
+ url = https://github.com/stze/splituapp.git
+[submodule "sinextract"]
+ path = sinextract
+ url = https://github.com/stze/anyxperia_dumper.git
diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 0000000..00f20ee
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,11 @@
+FROM ubuntu:20.04
+ENV DEBIAN_FRONTEND=noninteractive
+COPY . /extractor/
+RUN apt-get update
+#Install tzdata in non-interactive mode, otherwise it asks for timezones.
+RUN apt-get install -y --no-install-recommends tzdata
+RUN apt-get install -y python3 python3-pip swig
+RUN apt-get install -y git android-sdk-libsparse-utils liblz4-tool brotli unrar
+RUN apt-get install -y zip rsync
+RUN cd /extractor && pip3 install -r requirements.txt
+ENTRYPOINT ["/extractor/extractor.py"]
diff --git a/README.md b/README.md
index 67d0aab..2cd2fd0 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,67 @@
-# extractor
-Extractor: The Android firmware image extraction tool
+# Extractor · [![GitHub license](https://img.shields.io/badge/license-Apache%202.0-blue)](#LICENSE)
+
+
+
+
+
+Extractor is a powerful Android firmware image extraction utility
+
+# Installation
+To run Extractor on your computer some preparation steps are required. Since Extractor is a python tool, a working python environment is required. Extractor depends on some git submodules, all of which can be initialized like so
+
+```bash
+# Initialize git submodules
+./scripts/init.sh
+```
+
+If you wish to run Extractor without installing the necesarry requirements yourself, you may run it using docker.
+
+## Debian-based (Debian, Ubuntu)
+
+Currently supports Debian 10 and Ubuntu 20.04. Use a terminal shell to execute the following commands:
+
+```bash
+sudo apt update
+# Install dependencies
+sudo apt install -y git android-sdk-libsparse-utils liblz4-tool brotli unrar
+```
+
+We recommend using a python virtualenv for installing Extractors python dependencies:
+
+```bash
+# Create virtualenv in venv directory
+python3 -m venv venv
+# Activate virtualenv
+source venv/bin/activate
+```
+
+Now, install the python dependencies:
+
+```bash
+pip3 install -r requirements.txt
+```
+# Usage
+
+You can run Extractor on your machine by running:
+
+```bash
+sudo ./extractor.py --system-dir-output