Complete README, add screencapture

README.md

@@ -2,6 +2,8 @@ A search provider for Gnome-Shell that adds support for searching in [pass](http
 
 Names of passwords will show up in Gnome-Shell searches, choosing one will copy the corresponding content to the clipboard.
 
+![Sreencapture](misc/screencapture.gif)
+
 # Installation
 ## Packages
 
@@ -10,21 +12,54 @@ Names of passwords will show up in Gnome-Shell searches, choosing one will copy
 ## Manual
 
 Ensure that python-gobject is installed on your system (probably already the case):
-
+```shell
-`$PACKAGE_MANAGER install python-gobject`
+$PACKAGE_MANAGER install python-gobject
+```
 
 Download or clone this repository:
-
+```shell
-`git clone git@github.com:jle64/gnome-shell-pass-search-provider.git`
+git clone git@github.com:jle64/gnome-shell-pass-search-provider.git
+```
 
 Run the installation script as root:
+```shell
+sudo ./install.sh
+```
 
-`sudo ./install.sh`
+If you need to you can change the installation paths to suit your system:
+```shell
+sudo SYSCONFDIR=/etc DATADIR=/usr/share LIBDIR=/usr/lib LIBEXECDIR=/usr/lib ./install.sh
+```
 
-If you need to you can change the installation paths :
+The search provider should show up and be enabled in Gnome search preferences and be autoloaded by Gnome-Shell.
+If that's not the case try closing and reopening your Gnome session.
 
-`sudo SYSCONFDIR=/etc DATADIR=/usr/share LIBDIR=/usr/lib LIBEXECDIR=/usr/lib ./install.sh`
+# Environment variables
+
+If you are configuring pass through environment variables, such as `PASSWORD_STORE_DIR`, make sure to set them in a way that will propagate to the search provider executable.
+If you are on a systemd-based system, you can set them in the unit file :
+
+```shell
+systemctl --user edit org.gnome.pass.search.service
+```
+
+Add your variables like this :
+```ini
+[Service]
+Environment=PASSWORD_STORE_DIR=/my/passwords/path
+```
+Then restart the service :
+
+```shell
+systemctl --user restart org.gnome.pass.search.service
+```
 
 # Compatibility
 
-This implements the `org.gnome.Shell.SearchProvider2` D-Bus API. I'm not sure since when this has been in Gnome nor until when it will stay. This works fine on Gnome 3.22 and I expect it will continue to work for some time with ulterior versions.
+This implements the `org.gnome.Shell.SearchProvider2` D-Bus API.
+I'm not sure since when this has been in Gnome nor until when it will stay.
+This works fine on Gnome 3.22 and I expect it will continue to work for some time with ulterior versions.
+
+# Troubleshooting
+
+If this does not work for you, make sure to look to wherever Gnome and D-Bus are logging for error messages (in the journal on systemd-using systems).