diff --git a/depends.txt b/depends.txt
deleted file mode 100644
index db54710..0000000
--- a/depends.txt
+++ /dev/null
@@ -1,4 +0,0 @@
-default
-technic
-digilines?
-mesecons?
diff --git a/mod.conf b/mod.conf
new file mode 100644
index 0000000..b6fa3ba
--- /dev/null
+++ b/mod.conf
@@ -0,0 +1,4 @@
+name = spacecannon
+description = Adds three scifi/space cannons with various projectile-speed and explosion-strength
+depends = default, technic
+optional_depends = mesecons, digilines
diff --git a/readme.md b/readme.md
index 9f65be2..1e7f525 100644
--- a/readme.md
+++ b/readme.md
@@ -1,5 +1,96 @@
 
+Spacecannon mod
+
+# Overview
+
+Adds three scifi/space cannons with various projectile-speed and explosion-strength.
+The cannons need HV-Power from a `technic` network and can be controlled via formspec/hand, mesecons or digilines.
+They also need to charge first, which can take a couple of seconds depending on cannon-type.
+
+The projectile detonates on impact but only in _non-protected_ areas!
+
+# Screenshots
+
+<img src="./screenshot_1.png"/>
+<img src="./screenshot_2.png"/>
+<img src="./screenshot_3.png"/>
+
+
+# Dependencies
+
+Depends on:
+* `technic`
+
+Supports:
+* `mesecons`
+* `digilines`
+
+# Mesecons
+
+An "on" signal triggers a fire-action.
+
+# Digilines
+
+Fire a cannon:
+```lua
+if event.type == "program" then
+ digiline_send("cannon", { command="fire" })
+end
+```
+
+Example response from a "get" request:
+```lua
+{
+        type = "digiline",
+        channel = "c7",
+        msg = {
+                HV_EU_input = 0,
+                HV_EU_demand = 0,
+                dir = {
+                        y = 0,
+                        x = 0,
+                        z = 1
+                },
+                powerstorage = 10000,
+                ready = true,
+                origin = "c7",
+                name = "spacecannon:cannon_green",
+                pos = {
+                        y = 10,
+                        x = -64,
+                        z = -53
+                }
+        }
+}
+```
+
+Example response from a "fire" request:
+```lua
+{
+        type = "digiline",
+        channel = "c2",
+        msg = {
+                pos = {
+                        y = 10,
+                        x = -59,
+                        z = -53
+                },
+                origin = "c2",
+                success = true
+        }
+}
+```
+
+# Contributors
+
+* @BuckarooBanzay
+* @dennisjenkins75
+
+# License
+
+Code: MIT
+Textures: CC-BY-SA 3.0
+
 # Attributions
 
-
-* sounds/spacecannon_shoot.ogg https://freesound.org/people/jonccox/sounds/175261/
\ No newline at end of file
+* sounds/spacecannon_shoot.ogg https://freesound.org/people/jonccox/sounds/175261/
diff --git a/screenshot_1.png b/screenshot_1.png
new file mode 100644
index 0000000..7a087dc
Binary files /dev/null and b/screenshot_1.png differ
diff --git a/screenshot_2.png b/screenshot_2.png
new file mode 100644
index 0000000..2c3d4ce
Binary files /dev/null and b/screenshot_2.png differ
diff --git a/screenshot_3.png b/screenshot_3.png
new file mode 100644
index 0000000..efbd959
Binary files /dev/null and b/screenshot_3.png differ