diff --git a/README.md b/README.md
new file mode 100644
index 0000000..10e5f1b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,19 @@
+# feedprefs plugin
+
+Plugin for [Tiny Tiny RSS](https://tt-rss.org/) to make display preferences
+specific to each feed.
+
+# Installation
+
+- git clone the repository or install a copy in the plugins.local directory of
+  your tt-rss install.
+- Inside tt-rss, go to Configuration and enable the 'feedprefs' plugin
+
+# Usage
+
+each time you open a feed, View mode and Ordering Mode is restored to the same
+state than the last time you visited the feed.
+
+State is stored in broswer local storage. This means state is not shared if
+you use your Tiny Tiny RSS account from different browsers.
+