diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3fbf926
--- /dev/null
+++ b/README.md
@@ -0,0 +1,15 @@
+# pewmulator
+And emulator for running PewPew games on desktop computers
+
+To use it clone this repository, install the dependencies from the `requirements.txt` and work in the directory.
+```
+git clone https://github.com/pewpew-game/pewmulator.git
+cd pewmulator
+python -m pip install -r requirements.txt
+```
+
+Typically you want to start with a `code.py` that you can later copy to your hardware.
+
+The keys of the PewPew can be emulated by the arrow keys and `x` and `z`.
+
+The emulator does not support brightness.
diff --git a/requirements.txt b/requirements.txt
new file mode 100644
index 0000000..0cb7ff1
--- /dev/null
+++ b/requirements.txt
@@ -0,0 +1 @@
+pygame