diff --git a/README.md b/README.md
new file mode 100644
index 0000000..170eff4
--- /dev/null
+++ b/README.md
@@ -0,0 +1,23 @@
+# ![](res/shellfox-38.png) Shellfox
+
+[Shellfox](https://hak.xwx.moe/jadedctrl/shellfox) is a simple add-on for [Firefox](https://firefox.com) that allows you to run a shell command on a URL at the click of a button.
+
+<a alt="Screenshot of Shellfox." href="res/screenshot-youtube.png"><img width=400px src="res/screenshot-youtube.png"></a>
+
+
+## Installation
+Shellfox uses a native program in order to run commands; installing only the add-on isn’t enough.
+
+In order to install it, open a terminal and use the Makefile like so:
+
+```
+$ sudo make native-install
+```
+
+After that, you can install the add-on just fine!
+
+
+## Source code
+https://hak.xwx.moe/jadedctrl/shellfox  
+Author is Jaidyn Ann, <jadedctrl@posteo.at>  
+License is the [GNU GPLv3](LICENSE).
diff --git a/res/screenshot-youtube.png b/res/screenshot-youtube.png
new file mode 100644
index 0000000..0274532
Binary files /dev/null and b/res/screenshot-youtube.png differ