Improve kiosk docs (currently broken for slide show)

docs/kiosk.md

@@ -16,19 +16,104 @@
 groupadd -r autologin
 usermod -a -G autologin [user] 
 
-apt install unclutter chromium midori lxde lightdm xserver-xorg accountsservice
+apt install unclutter chromium midori lxde lightdm xserver-xorg accountsservice xscreensaver
 sed -i 's/#autologin-user=/autologin-user=[user]/g' /etc/lightdm/lightdm.conf
 systemctl restart lightdm
 
 cat >> /home/[user]/.config/lxsession/LXDE/autostart <<EOF
+# Overall screen setup / screensaver stuff
+@xscreensaver -no-splash
 @xset s off
 @xset -dpms
-@xset s noblank
-@sed -i 's/"exited_cleanly": false/"exited_cleanly": true/' ~/.config/chromium-browser Default/Preferences
+# Uncomment below to disable blanking screen
+#@xset s noblank
+
+# Midori (you probably want this over chromium -- comment below line if you really do want chromium)
+@midori -e Fullscreen -a https://home-assistant.domain.tld
+
+# Uncommend below 2 lines for chromium
+#@sed -i 's/"exited_cleanly": false/"exited_cleanly": true/' ~/.config/chromium-browser Default/Preferences
 #@chromium-browser --noerrdialogs --kiosk https://home-assistant.domain.tld --incognito --disable-translate
-#@midori -e Fullscreen -a https://home-assistant.domain.tld
 EOF
 
 systemctl restart lightdm
 
 ```
+
+## Slideshow of Photos as Screensaver
+
+**Currently BROKEN, help welcome**
+
+- [https://www.jwz.org/xscreensaver/faq.html#slideshow](https://www.jwz.org/xscreensaver/faq.html#slideshow)
+- [https://wiki.archlinux.org/index.php/XScreenSaver](https://wiki.archlinux.org/index.php/XScreenSaver)
+- [https://pimylifeup.com/raspberry-pi-photo-frame/](https://pimylifeup.com/raspberry-pi-photo-frame/)
+- [https://unix.stackexchange.com/questions/371209/configuring-feh-key-mapping-problems](https://unix.stackexchange.com/questions/371209/configuring-feh-key-mapping-problems)
+- [https://github.com/phillipberndt/pqiv](https://github.com/phillipberndt/pqiv)
+- [https://www.nongnu.org/fbi-improved/#man_fim](https://www.nongnu.org/fbi-improved/#man_fim)
+- [https://feh.finalrewind.org/](https://feh.finalrewind.org/)
+
+``` bash
+
+mkdir -p /tank/photos
+# copy files -> /tank/photos
+
+apt install feh fim pqiv at-spi2-core
+
+mkdir ~/.config/feh/
+cat > ~/.config/feh/buttons <<EOF
+# Left click: quit
+# Middle click: toggle filenames
+# Right click: toggle exif
+quit
+toggle_filenames
+toggle_exif
+pan
+zoom
+toggle_menu
+quit 1
+toggle_filenames 2
+toggle_exif 3
+EOF
+
+cat > ~/.config/feh/keys <<EOF
+quit
+next_img
+quit n, <Space>, <Right>, q
+EOF
+
+cat > ~/.pqivrc <<EOF
+[keybindings]
+<Mouse-1> { quit(); }
+EOF
+
+cat > ~/.xscreensaver<<EOF
+timeout:       0:15:00
+cycle:         0:05:00
+lock:          False
+lockTimeout:   0:00:00
+passwdTimeout: 0:00:30
+splash:        False
+fade:          False
+unfade:        False
+dpmsEnabled:   True
+dpmsStandby:   0:45:00
+dpmsSuspend:   1:00:00
+dpmsOff:       1:30:00
+
+mode:           one
+selected:       0
+
+programs: \\
+    /usr/bin/pqiv \\
+        --slideshow-interval 5 \\
+        --fullscreen \\
+        --hide-info-box \\
+        --lazy-load \\
+        --slideshow \\
+        --low-memory \\
+        --shuffle \\
+        --watch-directories \\
+        /tank/photos \\n\\
+EOF
+
+```