diff --git a/README.md b/README.md
new file mode 100644
index 0000000..08f496b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,37 @@
+# Monito multi-monitoring checker
+
+## Manual Installation
+
+If you install from sources/scratch, put the sources into the
+<kbd>~/.local/share/gnome-shell/extensions/monito@drieu.org</kbd>
+directory.  Then build the schema using either <kbd>make schema</kbd>
+or <kbd>glib-compile-schemas --strict schemas/</kbd>.
+
+Once this is done, reload gnome-shell (Alt-F2) and execute
+gnome-tweaks to enable the extension or alternatively the following
+command <kbd>gnome-extensions enable monito@drieu.org</kbd>.
+
+And voilà!
+
+
+## About
+
+This extension has been developed for my own needs.  I will maintain
+it and add features but it may be very crude, compared to the
+excellent *nagstamon* package, which only missed the ability to be put
+inside of the gnome-shell panel (this could not be developed).
+
+Things I plan to add at some point or another:
+
+  * Buttons to operate on services à la nagstamon (recheck, connect via SSH, etc.)
+  * Regexes to modify the output of services (to prune unecessary stuff)
+  * Filters to hide services (acked ones, or depending on regexes)
+  * Support for other (free as in free speech) monitoring servers
+  * Better tabular output of the services result (sorting, pagination)
+  * Choose which columns are shown in services result
+  * Better icinga2 support (use API because things are missing in the json output ?)
+
+Things I will be unlikely to add unless a patch is provided:
+
+  * Support for broken HTTPS certs
+  * Notification for new alerts