README.rst: Adding information regarding the conky@ user service.

1 files changed, 20 insertions, 0 deletions

diff --git a/README.rst b/README.rst
index 1aba7bf..146534c 100644
--- a/README.rst
+++ b/README.rst
@@ -56,6 +56,22 @@ ______________
      systemctl --user start compton
      systemctl --user enable compton
 
+conky@ --user
+______________
+| The |conky| user service needs a properly exported *$DISPLAY* variable to work. You can set this in your |systemd-user.conf|:
+
+  .. code:: ini
+
+    DefaultEnvironment=DISPLAY=:0
+
+| The |conky| user service starts conky scripts by name. This means, the word after the *@* directly relates to configuration files in your conky configuration directory (*~/.config/conky/*)
+| You can start and enable it like any other systemd user service, by supplying it with a configuration file name:  
+
+  .. code:: bash
+
+     systemctl --user start conky@my-configuration-name
+     systemctl --user enable conky@my-configuration-name
+
 cpupower-rt
 ___________
 | The cpupower package on |arch_linux| has been |cpupower_feature_request|, to allow easier appliance of CPU settings based on other profiles, than the system's default.
@@ -305,6 +321,10 @@ ______________
 
   <a href="https://github.com/chjj/compton/" target="_blank">compton</a>
 
+.. |conky| raw:: html
+
+  <a href="https://github.com/brndnmtthws/conky" target="_blank">conky</a>
+
 .. |real-time_kernel| raw:: html
 
   <a href="https://www.kernel.org/pub/linux/kernel/projects/rt/" target="_blank">real-time kernel</a>