diff --git a/misc/userscripts/README.md b/misc/userscripts/README.md
new file mode 100644
index 000000000..216ded6a9
--- /dev/null
+++ b/misc/userscripts/README.md
@@ -0,0 +1,32 @@
+# Userscripts
+
+- [cast](./cast): Cast content on your Chromecast using [castnow][]. Only
+  [youtube-dl][] downloadable content.
+- [dmenu_qutebrowser](./dmenu_qutebrowser): Pipes history, quickmarks, and URL into dmenu.
+- [format_json](./format_json): Pretty prints current page's JSON code in other
+  tab.
+- [getbib](./getbib): Scraping the current web page for DOIs and downloading
+  corresponding bibtex information.
+- [open_download](./open_download): Opens a rofi menu with
+  all files from the download directory and opens the selected file.
+- [openfeeds](./openfeeds): Opens all links to feeds defined in the head of a site.
+- [password_fill](./password_fill): Find a username/password entry and fill it
+  with credentials given by the configured backend (currently only pass) for the
+  current website.
+- [qute-keepass](./qute-keepass): Insertion of usernames and passwords from keepass
+  databases using pykeepass.
+- [qute-pass](./qute-pass): Insert login information using pass and a
+  dmenu-compatible application (e.g. dmenu, rofi -dmenu, ...).
+- [qutedmenu](./qutedmenu): Handle open -s && open -t with bemenu.
+- [readability](./readability): Executes python-readability on current page and
+  opens the summary as new tab.
+- [ripbang](./ripbang): Adds DuckDuckGo bang as searchengine.
+- [rss](./rss): Keeps track of URLs in RSS feeds and opens new ones.
+- [taskadd](./taskadd): Adds a task to taskwarrior.
+- [tor_identity](./tor_identity): Change your tor identity.
+- [view_in_mpv](./view_in_mpv): Views the current web page in mpv using
+  sensible mpv-flags.
+
+[castnow]: https://github.com/xat/castnow
+[youtube-dl]: https://rg3.github.io/youtube-dl/
+