From 406d9b5a9a43280ea5210ee10f3107570ec57a0a Mon Sep 17 00:00:00 2001
From: mzac <10270879+mzac@users.noreply.github.com>
Date: Sat, 2 May 2026 16:53:11 -0400
Subject: [PATCH 1/2] Add 'Run as a Kiosk' section to README
Added instructions for running the console as a kiosk on Raspberry Pi.
---
README.md | 23 +++++++++++++++++++++++
1 file changed, 23 insertions(+)
diff --git a/README.md b/README.md
index 4e15e35..0578f33 100644
--- a/README.md
+++ b/README.md
@@ -28,6 +28,7 @@ https://community.weatherflow.com/
**[Installation Instructions](#installation-instructions)**
**[Update Instructions](#update-instructions)**
**[Auto-Start Instructions](#auto-start-instructions)**
+**[Run as a Kiosk](#run-as-a-kiosk)**
**[Advanced: Custom Panels](#advanced-custom-panels)**
**[Advanced: Device Replacement](#advanced-device-replacement)**
**[Advanced: Windows Installation](#advanced-installation-windows)**
@@ -179,6 +180,28 @@ stop command or a hard shutdown:
wfpiconsole stop
```
+## Run as a Kiosk
+
+When the console is launched into the default Raspberry Pi OS LXDE session, the lxpanel taskbar can prevent the console from covering the full screen even with `Fullscreen = 1`. To run the Pi as a dedicated weather console with no desktop panel or icons, edit `/etc/xdg/lxsession/LXDE-pi/autostart` and remove (or comment out) the `@lxpanel` and `@pcmanfm --desktop` lines. Optionally add three `xset` lines to keep the display awake 24/7:
+
+```bash
+sudo cp /etc/xdg/lxsession/LXDE-pi/autostart /etc/xdg/lxsession/LXDE-pi/autostart.bak
+sudo tee /etc/xdg/lxsession/LXDE-pi/autostart > /dev/null <<'EOF'
+@xset s off
+@xset -dpms
+@xset s noblank
+EOF
+sudo reboot
+```
+
+To restore the original desktop:
+```bash
+sudo cp /etc/xdg/lxsession/LXDE-pi/autostart.bak /etc/xdg/lxsession/LXDE-pi/autostart
+sudo reboot
+```
+
+This change is system-wide and only applies to LXDE/X11 sessions. The Wayfire/Wayland sessions used on newer Raspberry Pi OS releases require a different approach.
+
## Advanced: Custom Panels
The console is distributed with 7 built-in panels to display weather, forecast
From a033fe0558ed4dd169793d36c45b058b5b780133 Mon Sep 17 00:00:00 2001
From: mzac <10270879+mzac@users.noreply.github.com>
Date: Sat, 2 May 2026 17:30:52 -0400
Subject: [PATCH 2/2] Update README with fullscreen configuration details
Add instructions for configuring fullscreen in Kivy.
---
README.md | 7 +++++++
1 file changed, 7 insertions(+)
diff --git a/README.md b/README.md
index 0578f33..ebf9415 100644
--- a/README.md
+++ b/README.md
@@ -202,6 +202,13 @@ sudo reboot
This change is system-wide and only applies to LXDE/X11 sessions. The Wayfire/Wayland sessions used on newer Raspberry Pi OS releases require a different approach.
+If after applying this you still see a window title bar with the bottom of the console clipped, openbox is putting the console in maximized state instead of true fullscreen. Force fullscreen at startup by also setting the following in `~/.kivy/config.ini` under `[graphics]`:
+
+```
+fullscreen = auto
+borderless = 1
+```
+
## Advanced: Custom Panels
The console is distributed with 7 built-in panels to display weather, forecast