diff --git a/README.rst b/README.rst
index 9f366574c1246a3afe3047e12970dc0c6abd33af..dd4bebe63a67f4b8c31adbbef6a6326a0b9eca96 100644
--- a/README.rst
+++ b/README.rst
@@ -46,10 +46,16 @@ To enable the extension, add the following to your ``mopidy.conf`` file::
     enabled = true
     # URL of your funkwhale instance
     url = https://demo.funkwhale.audio
-    # Username to use when authenticating (leave empty fo anonymous access)
-    username = demo
-    # Password to use when authenticating (leave empty fo anonymous access)
-    password = demo
+    # Application credentials (leave empty fo anonymous access)
+    # If you don't now what to put here, just run `mopidy funkwhale login` for
+    # the instructions
+    client_id =
+    client_secret =
+    # If for some reason, you want to use the legacy password-based auth,
+    # uncomment the variables below
+    # username = demo
+    # password = demo
+
     # duration of cache entries before they are removed, in seconds
     # 0 to cache forever, empty to disable cache
     cache_duration = 600
@@ -59,6 +65,13 @@ try using the demo server).
 
 After that, reload your mopidy daemon, and you should be good!
 
+Authorization
+-------------
+
+This plugin support the OAuth authorization workflow that is included in Funkwhale 0.19.
+
+Run ``mopidy funkwhale login`` to perform authorization.
+
 Todo
 ----