fix: touch event ignored #148

build: update version
docs: update readme
2025-12-15 11:13:12 +01:00 · 2025-12-09 16:30:40 +01:00 · 2025-12-09 16:11:48 +01:00 · 2025-12-09 15:51:49 +01:00 · 2025-12-09 15:49:51 +01:00 · 2025-12-09 13:53:23 +01:00
27 changed files with 7185 additions and 2080 deletions
@@ -0,0 +1,116 @@
+name: Report a bug in the application
+description: I encountered a bug that was not reported before.
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        This issue form is for reporting unknown bugs only!
+        - [x] I promise to have read the [FAQ](https://github.com/leukipp/touchkio/blob/main/HARDWARE.md#faq) section in the hardware documentation first! 🤞
+        - [x] I promise to have read the [ISSUES](https://github.com/leukipp/touchkio?tab=readme-ov-file#issues) section and know how to debug the application! 🤞
+        - [x] I also swear to have searched for similar open and closed issues on [GITHUB](https://github.com/leukipp/touchkio/issues?q=is%3Aissue) first! 🤞
+  - type: textarea
+    id: problem_description
+    validations:
+      required: true
+    attributes:
+      label: Problem description
+      placeholder: problem description
+      description: |
+        Describe the issue you are experiencing and how to reproduce it.
+  - type: markdown
+    attributes:
+      value: |
+        ## Details
+  - type: input
+    id: app_version
+    validations:
+      required: true
+    attributes:
+      label: What version of touchkio is used?
+      placeholder: v
+      description: >
+        Can be found on the MQTT device under `Diagnostics > Version`.
+  - type: input
+    id: operating_system
+    validations:
+      required: true
+    attributes:
+      label: What operating system and version is used?
+      description: >
+        Raspberry Pi OS (Trixie), Ubuntu (24.04), etc.
+  - type: dropdown
+    id: display_server
+    validations:
+      required: true
+    attributes:
+      label: Which display server is configured on the system?
+      description: >
+        Use `loginctl show-session $(loginctl show-user $(whoami) -p Display --value) -p Type --value` to find out.
+      options:
+        - Wayland
+        - X11
+        - Other
+  - type: input
+    id: system_hardware
+    validations:
+      required: true
+    attributes:
+      label: Which system hardware is used?
+      description: >
+        Raspberry Pi 5 (8GB RAM), Intel NUC 14 (16GB RAM), etc.
+  - type: input
+    id: screen_hardware
+    validations:
+      required: true
+    attributes:
+      label: Which screen hardware is used?
+      description: >
+        Waveshare 8" CAPLCD (768x1024), Raspberry Pi 7" Touch Display 2 (720x1280), etc.
+  - type: dropdown
+    id: screen_connection
+    validations:
+      required: true
+    attributes:
+      label: Which screen connection type is used?
+      description: >
+        Choose the connection type between your screen and the host machine.
+      options:
+        - DSI
+        - HDMI
+        - HDMI + USB
+        - Other
+  - type: markdown
+    attributes:
+      value: |
+        ## Diagnostics
+  - type: textarea
+    id: arguments_json
+    validations:
+      required: false
+    attributes:
+      label: Used arguments
+      placeholder: arguments json
+      description: |
+        You can use `cat ~/.config/touchkio/Arguments.json` to get the file content.
+      render: json
+  - type: textarea
+    id: log_file
+    validations:
+      required: false
+    attributes:
+      label: Log file
+      placeholder: drag-and-drop the file or copy-and-paste the full content here
+      description: |
+        From the host machine use `scp USER@IP:~/.config/touchkio/logs/main.log main.log` to download the log file.  
+        Alternatively, you can use `cat ~/.config/touchkio/logs/main.log` on a ssh connection to get the file content.
+  - type: textarea
+    id: additional_information
+    validations:
+      required: false
+    attributes:
+      label: Additional information
+      placeholder: additional information
+      description: |
+        If you have any additional information that might be useful, use this field.
@@ -0,0 +1,82 @@
+name: Request a new feature for the application
+description: I want to request a new feature that is not yet available.
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        This issue form is for requesting new features only!
+        - [x] I promise to have read the [FAQ](https://github.com/leukipp/touchkio/blob/main/HARDWARE.md#faq) section in the hardware documentation first! 🤞
+        - [x] I also swear to have searched for similar open and closed feature requests on [GITHUB](https://github.com/leukipp/touchkio/issues?q=is%3Aissue) first! 🤞
+  - type: textarea
+    id: feature_description
+    validations:
+      required: true
+    attributes:
+      label: Feature description
+      placeholder: feature description
+      description: |
+        Describe the feature you want to request and why it would be useful for others.
+  - type: markdown
+    attributes:
+      value: |
+        ## Details
+  - type: input
+    id: app_version
+    validations:
+      required: true
+    attributes:
+      label: What version of touchkio is used?
+      placeholder: v
+      description: >
+        Can be found on the MQTT device under `Diagnostics > Version`.
+  - type: input
+    id: operating_system
+    validations:
+      required: true
+    attributes:
+      label: What operating system and version is used?
+      description: >
+        Raspberry Pi OS (Trixie), Ubuntu (24.04), etc.
+  - type: dropdown
+    id: display_server
+    validations:
+      required: true
+    attributes:
+      label: Which display server is configured on the system?
+      description: >
+        Use `loginctl show-session $(loginctl show-user $(whoami) -p Display --value) -p Type --value` to find out.
+      options:
+        - Wayland
+        - X11
+        - Other
+  - type: input
+    id: system_hardware
+    validations:
+      required: true
+    attributes:
+      label: Which system hardware is used?
+      description: >
+        Raspberry Pi 5 (8GB RAM), Intel NUC 14 (16GB RAM), etc.
+  - type: input
+    id: screen_hardware
+    validations:
+      required: true
+    attributes:
+      label: Which screen hardware is used?
+      description: >
+        Waveshare 8" CAPLCD (768x1024), Raspberry Pi 7" Touch Display 2 (720x1280), etc.
+  - type: dropdown
+    id: screen_connection
+    validations:
+      required: true
+    attributes:
+      label: Which screen connection type is used?
+      description: >
+        Choose the connection type between your screen and the host machine.
+      options:
+        - DSI
+        - HDMI
+        - HDMI + USB
+        - Other
@@ -0,0 +1,82 @@
+name: General inquiry or suggestion for the project
+description: I want to ask a question or improve the documentation.
+title: "[General]: "
+labels: ["question"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        This issue form is for general inquiries only!
+        - [x] I promise that the `Report a bug in the application` issue form isn't suitable for my inquiry! 🤞
+        - [x] I promise that the `Request a new feature for the application` issue form isn't suitable for my inquiry! 🤞
+  - type: textarea
+    id: general_comment
+    validations:
+      required: true
+    attributes:
+      label: General comment
+      placeholder: general comment
+      description: |
+        Ask a question, request some help, leave a general information or suggest an improvement for the documentation.
+  - type: markdown
+    attributes:
+      value: |
+        ## Details (optional)
+  - type: input
+    id: app_version
+    validations:
+      required: false
+    attributes:
+      label: What version of touchkio is used?
+      placeholder: v
+      description: >
+        Can be found on the MQTT device under `Diagnostics > Version`.
+  - type: input
+    id: operating_system
+    validations:
+      required: false
+    attributes:
+      label: What operating system and version is used?
+      description: >
+        Raspberry Pi OS (Trixie), Ubuntu (24.04), etc.
+  - type: dropdown
+    id: display_server
+    validations:
+      required: false
+    attributes:
+      label: Which display server is configured on the system?
+      description: >
+        Use `loginctl show-session $(loginctl show-user $(whoami) -p Display --value) -p Type --value` to find out.
+      options:
+        - Wayland
+        - X11
+        - Other
+  - type: input
+    id: system_hardware
+    validations:
+      required: false
+    attributes:
+      label: Which system hardware is used?
+      description: >
+        Raspberry Pi 5 (8GB RAM), Intel NUC 14 (16GB RAM), etc.
+  - type: input
+    id: screen_hardware
+    validations:
+      required: false
+    attributes:
+      label: Which screen hardware is used?
+      description: >
+        Waveshare 8" CAPLCD (768x1024), Raspberry Pi 7" Touch Display 2 (720x1280), etc.
+  - type: dropdown
+    id: screen_connection
+    validations:
+      required: false
+    attributes:
+      label: Which screen connection type is used?
+      description: >
+        Choose the connection type between your screen and the host machine.
+      options:
+        - DSI
+        - HDMI
+        - HDMI + USB
+        - Other
@@ -0,0 +1 @@
+blank_issues_enabled: false
@@ -0,0 +1 @@
+github: leukipp
@@ -8,9 +8,6 @@ on:
 jobs:
  build:
    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        arch: [arm64]
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
@@ -30,4 +27,4 @@ jobs:
        env:
          GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}
        run: |
-          yarn electron-forge publish --arch arm64
+          yarn electron-forge publish --arch arm64,x64
@@ -1,3 +1,4 @@
 node_modules/
 docs/
 out/
+build.json
@@ -1,33 +1,273 @@
-# TouchKio - Supported Hardware
-This document contains an incomplete list of device and display hardware combinations that are either intended to be tested or have already been tested.
+# Supported Hardware
+This document contains an incomplete list of device and display hardware combinations that have already been tested.

-The [release](https://github.com/leukipp/touchkio/releases) page has builds exclusively for **arm64**, but custom builds for other architectures can be made (see [Development](https://github.com/leukipp/touchkio?tab=readme-ov-file#development)), allowing the application to operate on any hardware.
+The [release](https://github.com/leukipp/touchkio/releases) page has builds exclusively for **arm64** and **x64**, but custom builds for other architectures can be made (see [development](https://github.com/leukipp/touchkio?tab=readme-ov-file#development)), allowing the application to operate on any hardware.
 At least the **minimal** features, such as displaying a **kiosk window** (which doesn't necessarily need to be Home Assistant) will work.

 ## Hardware
-Any SBC clones of the Raspberry Pi that operate on **Raspberry Pi OS (64-bit)** and **Wayland** are likely to function as well.
+If you are running Linux with a graphical user interface (Wayland or X11), you should be well equipped to use the application. Additionally, any single board computer (SBC) clones of the Raspberry Pi that operate on Raspberry Pi OS **(64-bit)** are likely to function as well.
+
+|     | Status                | Notes                                                                     |
+| --- | --------------------- | ------------------------------------------------------------------------- |
+| 🟩   | Fully operational     | Working display power, brightness and keyboard control via MQTT.          |
+| 🟨   | Partially operational | Display brightness control is not available via MQTT.                     |
+| 🟧   | Partially operational | Display brightness and keyboard control is not available via MQTT.        |
+| 🟥   | Partially operational | Display power, brightness and keyboard control is not available via MQTT. |
+| ⬜   | Somehow operational   | Issues can occur and the overall performance is very slow.                |
+| ⬛   | Not operational       | The house is on fire.                                                     |

 ### DSI
-| Device         | Display                                                                                         | Tested | Status            | Notes                                                  |
-| -------------- | ----------------------------------------------------------------------------------------------- | ------ | ----------------- | ------------------------------------------------------ |
-| Raspberry Pi 3 | [Official 7" Touch Display 1](https://www.raspberrypi.com/products/raspberry-pi-touch-display/) | ❌      | Unknown           | 99% chance that it is slow and the resolution sucks.   |
-| Raspberry Pi 3 | [Official 7" Touch Display 2](https://www.raspberrypi.com/products/touch-display-2/)            | ❌      | Unknown           | 99% chance that it is slow.                            |
-| Raspberry Pi 4 | [Official 7" Touch Display 1](https://www.raspberrypi.com/products/raspberry-pi-touch-display/) | ❌      | Unknown           | 99% chance that the resolution sucks.                  |
-| Raspberry Pi 4 | [Official 7" Touch Display 2](https://www.raspberrypi.com/products/touch-display-2/)            | ❌      | Optimistic        | 99% chance that it fully works.                        |
-| Raspberry Pi 5 | [Official 7" Touch Display 1](https://www.raspberrypi.com/products/raspberry-pi-touch-display/) | ❌      | Unknown           | 99% chance that the resolution sucks.                  |
-| Raspberry Pi 5 | [Official 7" Touch Display 2](https://www.raspberrypi.com/products/touch-display-2/)            | ✅      | Fully operational | Working display power and brightness control via MQTT. |
+| Device                 | System                                 | Display                                                                                                  | Status |
+| ---------------------- | -------------------------------------- | -------------------------------------------------------------------------------------------------------- | ------ |
+| Raspberry Pi 3 (arm64) | Raspberry Pi OS (64-bit), Wayland, X11 | [Official 7" Touch Display 1 (800x480)](https://www.raspberrypi.com/products/raspberry-pi-touch-display) | ⬜      |
+| Raspberry Pi 3 (arm64) | Raspberry Pi OS (64-bit), Wayland, X11 | [Official 7" Touch Display 2 (720x1280)](https://www.raspberrypi.com/products/touch-display-2)           | ⬜      |
+| Raspberry Pi 4 (arm64) | Raspberry Pi OS (64-bit), Wayland, X11 | [Official 7" Touch Display 1 (800x480)](https://www.raspberrypi.com/products/raspberry-pi-touch-display) | 🟩      |
+| Raspberry Pi 4 (arm64) | Raspberry Pi OS (64-bit), Wayland, X11 | [Official 7" Touch Display 2 (720x1280)](https://www.raspberrypi.com/products/touch-display-2)           | 🟩      |
+| Raspberry Pi 5 (arm64) | Raspberry Pi OS (64-bit), Wayland, X11 | [Official 7" Touch Display 1 (800x480)](https://www.raspberrypi.com/products/raspberry-pi-touch-display) | 🟩      |
+| Raspberry Pi 5 (arm64) | Raspberry Pi OS (64-bit), Wayland, X11 | [Official 7" Touch Display 2 (720x1280)](https://www.raspberrypi.com/products/touch-display-2)           | 🟩      |
+| Raspberry Pi 5 (arm64) | Raspberry Pi OS (64-bit), Wayland, X11 | [Waveshare 10.1" DSI Touch (800x1280)](https://www.waveshare.com/10.1-dsi-touch-a.htm)                   | 🟩      |
+| Raspberry Pi 5 (arm64) | Raspberry Pi OS (64-bit), Wayland, X11 | [Waveshare 12.3" DSI Touch (720x1920)](https://www.waveshare.com/12.3-dsi-touch-a.htm)                   | 🟩      |

 ### HDMI
-| Device         | Display           | Tested | Status                | Notes                                                 |
-| -------------- | ----------------- | ------ | --------------------- | ----------------------------------------------------- |
-| Raspberry Pi 4 | -                 | ✅      | Partially operational | -                                                     |
-| Raspberry Pi 5 | Generic Non-Touch | ✅      | Partially operational | Display brightness control is not available via MQTT. |
+| Device                    | System                                 | Display                                                                                                                                                            | Status |
+| ------------------------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ |
+| Raspberry Pi 4 (arm64)    | Raspberry Pi OS (64-bit), Wayland, X11 | [LAFVIN Touch Display 5" (800x480)](https://www.amazon.de/gp/product/B0BWJ8YP7S)                                                                                   | 🟨      |
+| Raspberry Pi 4 (arm64)    | Raspberry Pi OS (64-bit), Wayland, X11 | [Waveshare 7EP-CAPLCD 7" (1280x800)](https://www.waveshare.com/7ep-caplcd.htm)                                                                                     | 🟨      |
+| Raspberry Pi 4 (arm64)    | Raspberry Pi OS (64-bit), Wayland, X11 | [Waveshare CAPLCD 8" (768x1024)](https://www.waveshare.com/wiki/8inch_768x1024_LCD)                                                                                | 🟨      |
+| Raspberry Pi 4 (arm64)    | Raspberry Pi OS (64-bit), Wayland, X11 | [EVICIV 10.1" Touch (1920x1200)](https://de.aliexpress.com/item/1005001870058398.html?spm=a2g0o.order_list.order_list_main.10.21ef5c5fCTxEDm&gatewayAdapt=glo2deu) | 🟨      |
+| Raspberry Pi 4 (arm64)    | Raspberry Pi OS (64-bit), Wayland, X11 | [Hannspree HT225 21.5" (1920x1080)](https://www.hannspree.eu/product/HT-225-HPB)                                                                                   | 🟨      |
+| Raspberry Pi CM 4 (arm64) | Raspberry Pi OS (64-bit), Wayland, X11 | [Lenovo ThinkCentre 23.8" (1920x1080)](https://psref.lenovo.com/Detail/ThinkCentre_Tiny_In_One_24_Gen_5?M=12NBGAT1EU)                                              | 🟨      |
+| Raspberry Pi 400 (arm64)  | Raspberry Pi OS (64-bit), Wayland, X11 | [UPerfect Vertical Touch 15.6" (1920x1080)](https://uperfect.com/products/uperfect-y-vertical-monitor-15-6)                                                        | 🟨      |
+| Raspberry Pi 5 (arm64)    | Raspberry Pi OS (64-bit), Wayland, X11 | [GeeekPi Capacitive Touch 10.1" (1280x800)](https://www.amazon.nl/dp/B0DHV6DZC1)                                                                                   | 🟨      |
+| Raspberry Pi 5 (arm64)    | Raspberry Pi OS (64-bit), Wayland, X11 | [ELECROW Portable Monitor 10.1" (1280x800)](https://www.amazon.co.uk/dp/B0BHHQLKPY)                                                                                | 🟨      |
+| Raspberry Pi 5 (arm64)    | Raspberry Pi OS (64-bit), Wayland, X11 | [Waveshare Capacitive Touch 14" (2160x1440)](https://www.waveshare.com/14inch-2160x1440-lcd.htm)                                                                   | 🟨      |
+| Raspberry Pi 5 (arm64)    | Raspberry Pi OS (64-bit), Wayland, X11 | [Akntzcs Portable Touch HD 16" (1920x1200)](https://www.amazon.com/dp/B0CTGW6MQ6)                                                                                  | 🟨      |
+| Raspberry Pi 5 (arm64)    | Raspberry Pi OS (64-bit), Wayland, X11 | [Prechen Portable Touch FHD 18.5" (1920x1080)](https://www.amazon.de/dp/B0CT2KLDBQ)                                                                                | 🟨      |
+| Raspberry Pi 5 (arm64)    | Raspberry Pi OS (64-bit), Wayland, X11 | Generic Non-Touch                                                                                                                                                  | 🟨      |
+| Generic PC (x64)          | Debian KDE (64-bit), Wayland, X11      | Generic Non-Touch                                                                                                                                                  | 🟧      |
+| Generic PC (x64)          | Ubuntu XFCE (64-bit), X11              | Generic Non-Touch                                                                                                                                                  | 🟧      |
+| Generic PC (x64)          | Ubuntu GNOME (64-bit), X11             | Generic Non-Touch                                                                                                                                                  | 🟧      |
+| Generic PC (x64)          | Ubuntu GNOME (64-bit), Wayland         | Generic Non-Touch                                                                                                                                                  | 🟥      |
+
+## Features
+**Minimal features** are designed to run on any system without issues:
+- A webview kiosk window launched in fullscreen mode and loading the specified `--web-url` website should not cause any problems.
+
+**Extended features** become available when the `--mqtt-*` arguments are provided and the hardware is supported:
+- If your hardware is not fully compatible there should be no crashes, but you may miss some sensors.
+
+Hardware support is verified during application startup and can be checked in the terminal or in the log file under the `Supported` section.
+The necessary requirements for MQTT sensors to work are listed here:
+| Name                 | Requirements                                                                                                  | References                                                                                                   |
+| -------------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
+| App (Update)         | Requires `sudo` rights, `.deb` install and `touchkio.service` running .                                       | [#70](https://github.com/leukipp/touchkio/issues/70), [#77](https://github.com/leukipp/touchkio/issues/77)   |
+| Display (Status)     | Working `wlopm`, `kscreen-doctor` or `xset` command.                                                          | [#38](https://github.com/leukipp/touchkio/issues/38), [#57](https://github.com/leukipp/touchkio/issues/57)   |
+| Display (Brightness) | Requires `sudo` rights, device under `/sys/class/backlight/*/brightness` exists or working `ddcutil` command. | [#30](https://github.com/leukipp/touchkio/issues/30), [#101](https://github.com/leukipp/touchkio/issues/101) |
+| Keyboard             | Raspberry Pi OS (Wayland) with `squeekboard` running.                                                         | [#7](https://github.com/leukipp/touchkio/issues/7), [#85](https://github.com/leukipp/touchkio/issues/85)     |
+| Battery              | Device under `/sys/class/power_supply/*/capacity` exists.                                                     | [#33](https://github.com/leukipp/touchkio/issues/33)                                                         |
+| Volume               | Device (non-dummy) `pactl get-default-sink` exists.                                                           | [#82](https://github.com/leukipp/touchkio/issues/82)                                                         |
+| Reboot               | Requires password-less `sudo` rights.                                                                         | [#39](https://github.com/leukipp/touchkio/issues/39)                                                         |
+| Shutdown             | Requires password-less `sudo` rights.                                                                         | [#39](https://github.com/leukipp/touchkio/issues/39)                                                         |
+
+## FAQ
+
+### Operating System
+
+<details><summary>I have installed Ubuntu GNOME.</summary>
+
+  - On some Debian based systems (e.g. Ubuntu GNOME), the display status control is only available when using X11 (`xset`).
+  - GNOME is the least supported window manager.
+    - It's recommended to switch to KDE wayland, if you want better support for display status control (`kscreen-doctor`).
+
+</details>
+
+<details><summary>I have installed Raspberry Pi OS on a RPI3.</summary>
+
+  - Raspberry Pi 3 devices have produced a bunch of issues in the past.
+    - [RPI 3B thermostat card issue](https://github.com/leukipp/touchkio/issues/17).
+    - [RPI 3B wayland rendering issue](https://github.com/leukipp/touchkio/issues/104).    
+    - [Webpage cards don't work (RPI 3B)](https://github.com/leukipp/touchkio/issues/24).
+ - It looks like the GPU is not properly supported by Electron.
+    - Running `touchkio --disable-gpu` may improve the situation, but upgrading the hardware is the best solution.
+
+</details>
+
+<details><summary>I want to update APT packages automatically.</summary>
+
+  - The **Package Upgrades** MQTT sensor will show if `apt` package upgrades are available, but updates are [intentionally](https://github.com/leukipp/touchkio/issues/7) not triggered by TouchKio.
+  - It's recommended to keep your system up to date for security and compatibility, as TouchKio primarily supports the latest OS versions. 
+    - Consider configuring `sudo apt install unattended-upgrades` for automatic updates.
+
+</details>
+
+### Display
+
+<details><summary>Display status can't be controlled through MQTT.</summary>
+
+  - The following commands are currently implemented to modify the display status. Make sure that one of these works for your display when you run it directly on the terminal, otherwise the MQTT switch will not work either.
+    - `wlopm --[on,off] \*` (Raspberry Pi OS, Wayland)
+    - `kscreen-doctor --dpms [on,off]` (Debian KDE, Wayland)
+    - `xset dpms force [on,off]` (Generic, X11)
+
+</details>
+
+<details><summary>Display brightness can't be controlled through MQTT.</summary>
+
+  - Have a look at the [features](https://github.com/leukipp/touchkio/blob/main/HARDWARE.md#features) section to check if all requirements are fulfilled.
+    - The **Display** MQTT control is a light entity with brightness support. So make sure to to [click on the entity](https://github.com/leukipp/touchkio/issues/75) to check for brightness support.
+  - HDMI screens typically do not offer brightness control out of the box, so additional setup steps are required.
+    - Brightness support for [ddcutil](https://github.com/leukipp/touchkio/issues/101#issuecomment-3521247263) is build-in and checked on application startup.
+    - Alternatively installing [ddcci-driver-linux](https://github.com/leukipp/touchkio/issues/132#issue-3659009749) or [ddcci-dkms](https://github.com/leukipp/touchkio/issues/101#issuecomment-3571523927) may also work.
+  - Make sure that one of these works for your display when you run it directly on the terminal, otherwise the MQTT switch will not work either.
+    - `sudo cat /sys/class/backlight/*/brightness` returns some numeric value.
+    - `sudo ddcutil setvcp 10 42` changes the brightness to 42% without asking for a password.
+
+</details>
+
+<details><summary>Turning HDMI screen off via MQTT causes it to turn back on.</summary>
+
+  - There are certain HDMI screens (e.g. Viewsonic) where the MQTT display status command doesn't work as expected. 
+    - The screen [immediately turns on again](https://github.com/leukipp/touchkio/issues/38), which may be caused by incompatible HDMI cables being used.
+
+</details>
+
+### Touch
+
+<details><summary>Automated screen blanking on inactivity.</summary>
+
+  - You can use Raspberry Pi's build-in [screen blanking](https://www.raspberrypi.com/documentation/computers/configuration.html#screen-blanking-3) functionality, however, if the screen is turned on through Home Assistant after being automatically turned off, it will remain on indefinitely.
+    - It's recommended to either use the built-in screen blanking feature or implement a Home Assistant [automation](https://www.home-assistant.io/docs/automation/basics) (e.g. presence detection or **Last Active** MQTT sensor) to manage the screen status.
+
+</details>
+
+<details><summary>Touch in multitouch mode not waking the screen.</summary>
+
+  - It's recommended to use **Mouse Emulation** for touch screens, otherwise touch based [screen wake-up](https://github.com/leukipp/touchkio/issues/127) from display off state will fail, especially if build-in [screen blanking](https://www.raspberrypi.com/documentation/computers/configuration.html#screen-blanking-3) is disabled.
+
+</details>
+
+<details><summary>Touch events may propagate through a display that is turned off.</summary>
+
+  - It's recommended to use **Mouse Emulation** for touch screens, otherwise Home Assistant actions could be triggered [unintentionally](https://github.com/leukipp/touchkio/issues/61) on touch.
+
+</details>
+
+### Network
+
+<details><summary>Connecting via https/mqtts with a self-signed certificate.</summary>
+
+  - When connecting to a service with a [custom certificate](https://github.com/leukipp/touchkio/issues/42#issuecomment-3041870215), ensure the specified FQDN matches.
+    - Using the `--ignore-certificate-errors` flag is [not recommended](https://github.com/leukipp/touchkio/issues/76) for browsing external sites.
+
+</details>
+
+<details><summary>Local DNS entries in /etc/hosts are ignored.</summary>
+
+  - Electron bypasses the system resolver stack, ignoring `/etc/hosts` and local DNS servers.
+    - To use the system resolver, modify `~/.config/systemd/user/touchkio.service` to disable these features:
+    ```bash
+    ExecStart=/usr/bin/touchkio --disable-features=UseDNSHttps,AsyncDns
+    ```
+
+</details>
+
+<details><summary>During VNC access the display turns gray.</summary>
+
+  - On Raspberry Pi OS the display command may fail with `ERROR: Setting power mode for output '[DSI-*,HDMI-*]' failed`.
+    - This can happen if you have `wayvnc` running for remote access and is caused by a [known bug](https://github.com/leukipp/touchkio/issues/78).
+
+</details>
+
+### Media
+
+<details><summary>I need Music and Voice Assistant.</summary>
+
+  - Not planned, look for [alternatives](https://github.com/leukipp/touchkio/issues/88#issuecomment-3366659265).
+
+</details>
+
+<details><summary>I need a camera stream from the device.</summary>
+
+  - Not planned, look for [alternatives](https://github.com/leukipp/touchkio/issues/130#issuecomment-3591770594).
+
+</details>
+
+<details><summary>I need additional MQTT entities to control hardware.</summary>
+
+  - Not planned, look for [alternatives](https://github.com/leukipp/touchkio/issues/138#issuecomment-3591784725).
+
+</details>
+
+### Dependencies
+
+<details><summary>Some of the MQTT controls are missing.</summary>
+
+  - Certain [features](https://github.com/leukipp/touchkio/blob/main/HARDWARE.md#features) from the MQTT integration may require elevated privileges to work correctly.
+    - Test if your local user has the [necessary permissions](https://github.com/leukipp/touchkio/issues/39) to run `sudo -n true` without being [prompted for a password](https://github.com/leukipp/touchkio/issues/116#issuecomment-3471566411).
+
+</details>
+
+<details><summary>The ddcutil command doesn't seem to be used.</summary>
+
+  - Currently `ddcutil` is only used for brightness control of HDMI screens.
+    - Make sure that your screen is supporting [continuous](https://github.com/leukipp/touchkio/issues/101#issuecomment-3521247263) adjustments of brightness values.
+
+</details>
+
+<details><summary>The on-screen keyboard doesn't automatically pop-out.</summary>
+
+  - Most of the available on-screen keyboards will not render above any [fullscreen window](https://forums.raspberrypi.com/viewtopic.php?p=2327148).
+  - There is a [workaround](https://github.com/leukipp/touchkio/issues/85) for `squeekboard`, which will only work on Raspberry Pi OS.
+    - If the on-screen keyboard still doesn't [automatically pop-out](https://github.com/leukipp/touchkio/issues/4) when entering a text field inside the webview you can use the side [widget](https://github.com/leukipp/touchkio/issues/16) to toggle the visibility.
+
+</details>
+
+### Errors
+
+<details><summary>Terminal is full with "ERROR:gbm_wrapper.cc" messages.</summary>
+
+  - On the terminal you may see some _ERROR:gbm_wrapper.cc_ messages.
+    - This appears to be a [known issue](https://github.com/electron/electron/issues/42322) that currently lacks a fix, but the webview still works.
+
+</details>
+
+<details><summary>CPU and RAM usage increases without reason.</summary>
+
+  - This was [especially observed](https://github.com/leukipp/touchkio/issues/123) when the screen is permanently on and renders a dashboard with interactive elements (e.g. custom lovelace cards).  
+    - Switching to another **Page Url** or turning the **Display** off during idle times improves resource usage.  
+    - Alternatively a timed **Refresh** of the webview via MQTT can also help.
+
+</details>
+
+<details><summary>Error message "GPU Process abnormal-exit".</summary>
+
+  - _GPU Process abnormal-exit (code 512)_ means that the Electron GPU process crashed, probably caused by some issues inside the webview.
+    - Disabling the GPU via `touchkio --disable-gpu` may help.
+ 
+</details>
+
+<details><summary>Error message "Render Process killed".</summary>
+
+  - _Render Process killed (code 9)_ will lead to a temporary [white screen](https://github.com/leukipp/touchkio/issues/115).
+  - The problem likely stems from Electron’s calculated RAM limit (~2GB) and the dashboard using too much memory.
+    - Although there are flags to [increase the limit](https://github.com/leukipp/touchkio/issues/36#issuecomment-3406441947), a standard webview shouldn’t require that much RAM.
+
+</details>

 ## Contributions
 In case your hardware is not listed above don't worry, give it a try.
 Running `touchkio --web-url=https://demo.home-assistant.io` will most likely just work.
 The only problems that may arise are when controlling the display via the Home Assistant integration.

+There is a possibility to test `pre-releases` if you would like to try upcoming versions before the official release is published.
+These early builds are available to a smaller group of users who have chosen to take part in testing.
+
+If you are interested in long-term testing, check out the related [help request](https://github.com/leukipp/touchkio/issues/96).
+When a [pre-release](https://github.com/leukipp/touchkio/releases) is available and you want to test it on-demand, run:
+```bash
+bash <(wget -qO- https://raw.githubusercontent.com/leukipp/touchkio/main/install.sh) update early
+```
+
 - If you encounter any problems, please create a new [issue](https://github.com/leukipp/touchkio/issues).
 - If you encounter any problems and are able to fix it yourself, feel free to create a [pull request](https://github.com/leukipp/touchkio/pulls).
- If everything works as expected and your hardware is not yet listed, you are welcome to add it and create a [pull request](https://github.com/leukipp/touchkio/pulls).
+- If everything works as expected and your hardware is not yet listed, you are welcome to [report](https://github.com/leukipp/touchkio/issues/12) it or create a [pull request](https://github.com/leukipp/touchkio/pulls).
@@ -1,32 +1,50 @@
 # TouchKio
-**TouchKio** is a Node.js application that utilizes **Electron** to create a kiosk mode specifically designed for a Home Assistant dashboard (or any other [webpage](https://github.com/leukipp/touchkio/blob/main/HARDWARE.md)).
-This tool is packaged as a **.deb** file, making it easy to launch the kiosk mode on a **Raspberry Pi** (or similar [hardware](https://github.com/leukipp/touchkio/blob/main/HARDWARE.md)) equipped with a touch display.
+[![build](https://img.shields.io/github/actions/workflow/status/leukipp/touchkio/release.yml?style=flat-square)](https://github.com/leukipp/touchkio/actions)
+[![date](https://img.shields.io/github/release-date/leukipp/touchkio?style=flat-square)](https://github.com/leukipp/touchkio/releases)
+[![platform](https://img.shields.io/badge/platform-%20arm64%20|%20x64%20-teal?style=flat-square)](https://github.com/leukipp/touchkio/releases)
+[![downloads](https://img.shields.io/github/downloads/leukipp/touchkio/total?style=flat-square)](https://github.com/leukipp/touchkio/releases)
+[![sponsor](https://img.shields.io/github/sponsors/leukipp?color=red&logo=github&style=flat-square)](https://github.com/sponsors/leukipp)
+
+**TouchKio** is a Node.js application that utilizes Electron to create a kiosk mode window specifically designed for a Home Assistant dashboard.
+This tool is packaged as a **.deb** file, making it easy to launch the kiosk application on any Debian based Linux [hardware](https://github.com/leukipp/touchkio/blob/main/HARDWARE.md) (e.g. **Raspberry Pi**) equipped with a **DSI or HDMI** Touch Display.
+Additional releases for other Linux systems are available as **.zip** file.

 [![display](https://raw.githubusercontent.com/leukipp/touchkio/main/img/display.png)](https://github.com/leukipp/touchkio/blob/main/img/display.png)

-This implementation addresses common issues encountered when using the built-in browser running in fullscreen mode on the Raspberry Pi with touch display.
+This implementation addresses common issues encountered when using the built-in browser running in fullscreen mode on a Linux device with Touch Display.
 Moreover, the device running the **kiosk application** also offers several **Home Assistant MQTT** sensors, enhancing it's functionality for automation purposes.

 ## Features
 - [x] Fast and easy setup.
- [x] Touch friendly web browser interface.
- [x] Configurable zoom and theme support. 
- [x] Single-tap screen wake-up functionality.
+- [x] Remember login credentials.
+- [x] Touch optimized web browsing.
+- [x] Dynamic window status bar layout.
+- [x] Side panel widget for kiosk control.
+- [x] Navigation bar to switch between pages.
+- [x] Adjustable browser zoom and theme support.
+- [x] Extended touch screen wake-up functionality.
 - [x] Remote controllable via MQTT.
-  - [x] Manage kiosk window status.
+  - [x] Toggle the on-screen keyboard.
  - [x] Touch display power and brightness.
+  - [x] Manage kiosk window status and zoom.
+  - [x] Screenshot image of the kiosk webview.
+  - [x] Show network interfaces and addresses.
+  - [x] List all available system package upgrades.
+  - [x] Multi-webpage switching and url navigation.
+  - [x] Volume control for connected audio outputs.
  - [x] Execute system reboot and shutdown commands.
-  - [x] Monitor temperature, processor and memory usage.
+  - [x] Monitor battery, temperature, processor and memory usage.

 The kiosk application can be executed with command line arguments to load a **Home Assistant dashboard in fullscreen** mode.
-Additionally, a **MQTT endpoint** can be defined, allowing the application to provide controls and sensors for the Raspberry Pi and the connected touch display.
+Additionally, a **MQTT endpoint** can be defined, allowing the application to provide controls and sensors for the Linux device and the connected Touch Display.

 ## Setup
-Before you begin, make sure that you have a Raspberry Pi configured and operational with a [compatible touch display](https://github.com/leukipp/touchkio/blob/main/HARDWARE.md).
-This guide assumes that you are using the latest version of **Raspberry Pi OS (64-bit)** together with a **Wayland** based desktop environment.
+Before you begin, make sure that you have a Linux device configured and operational with a [compatible](https://github.com/leukipp/touchkio/blob/main/HARDWARE.md) Touch Display.
+This guide assumes that you are using a Raspberry Pi with the latest version of Raspberry Pi OS **(64-bit)**, along with a desktop environment (preferred using **labwc**).
+However, the **.deb** setup procedure is also compatible with any other Debian based 64-bit system.

 ### Optional
-To utilize the sensor features of your display through Home Assistant, it's essential to have a **MQTT broker running** and the **MQTT integration installed** on your Home Assistant instance.
+To utilize the sensor features of your device through Home Assistant, it's essential to have a **MQTT broker running** and the **MQTT integration installed** on your Home Assistant instance.
 This setup allows seamless communication between your kiosk device and Home Assistant, enabling **real-time data exchange**.

 [![mqtt](https://raw.githubusercontent.com/leukipp/touchkio/main/img/mqtt.png)](https://github.com/leukipp/touchkio/blob/main/img/mqtt.png)
@@ -34,27 +52,60 @@ This setup allows seamless communication between your kiosk device and Home Assi
 For a comprehensive guide on setting up MQTT with Home Assistant, please refer to the official documentation available here: https://www.home-assistant.io/integrations/mqtt.

 ## Installation
-On the first run of the application, you may encounter a **setup procedure** and the Home Assistant **login screen**.
-It's recommended to create a **dedicated user** (local access only) for your kiosk device.
-You might also need a keyboard or remote VNC access to input these credentials once.
+On the first run of the application, you will encounter a **setup procedure (CLI)** and the Home Assistant **login screen (UI)**.
+It's recommended to create a dedicated Home Assistant user (local access only) for your kiosk device.
+
+You might also need a physical keyboard or remote VNC access to input these credentials once.
+If your hardware is [supported](https://github.com/leukipp/touchkio/blob/main/HARDWARE.md) you may be able to activate the on-screen keyboard using the side [widget](https://github.com/leukipp/touchkio/issues/16).
+After the first login the Home Assistant credentials are stored inside the `~/.config/touchkio/` folder.

 #### Option 1 - The easy way
-Run this command to download and install the release **.deb** file. It will also adjust some permissions, create a systemd file for auto-startup and will guide you through the setup process:
+Run this command to download and install the latest **.deb** (arm64 or x64) release.
+It will also create a systemd user file for auto-startup and will guide you through the setup process:
 ```bash
 bash <(wget -qO- https://raw.githubusercontent.com/leukipp/touchkio/main/install.sh)
 ```
+Make sure that you run this with your **standard user** and not with root (sudo).
 If you are paranoid, or smart, or both, have a look into the [install.sh](https://github.com/leukipp/touchkio/blob/main/install.sh) script before executing external code on your machine.

-#### Option 2 - The hard way
-The [install.sh](https://github.com/leukipp/touchkio/blob/main/install.sh) script mentioned above performs the following tasks (and you just have to do it manually):
- [Download](https://github.com/leukipp/touchkio/releases/latest) the latest **.deb** file,
-which is specifically suitable for Raspberry Pi **(64-bit)** ARM architecture.
- Open a terminal and execute the following command to install the application, e.g:
-`sudo dpkg -i touchkio_1.x.x_arm64.deb`
- If you just want to load a Home Assistant dashboard without further control you are good to go, e.g: `touchkio --web-url=https://demo.home-assistant.io`
+The systemd **user service** is enabled by default and the kiosk application should start automatically the next time you boot.
+If you need manual control use:
+```bash
+systemctl --user start|stop|status|restart touchkio.service
+```

-If you need the application to be automatically started on boot, create a **systemd file**.  
-If you need the Home Assistant MQTT sensors, create the **udev rule** for backlight control.
+<details><summary>Alternatives</summary><div>
+
+#### Option 2 - The standard way
+When connected via SSH, it's necessary to export the display variables first, as outlined in the [development](https://github.com/leukipp/touchkio?tab=readme-ov-file#development) section.
+The [install.sh](https://github.com/leukipp/touchkio/blob/main/install.sh) script mentioned above performs the following tasks (and you just have to do it manually):
+- [Download](https://github.com/leukipp/touchkio/releases/latest) the latest version file that is suitable for your architecture (arm64 or x64).
+  - Debian (**deb**): Open a terminal and execute the following command to install the application, e.g: `sudo apt install ./touchkio_1.x.x_arm64.deb && touchkio --setup`
+  - Others (**zip**): Extract the archive and run the binary, e.g: `unzip touchkio-linux-x64-1.x.x.zip && cd touchkio-linux-x64 && ./touchkio --setup`
+- If you just want to load a Home Assistant dashboard without further control you are good to go, e.g: `touchkio --web-url=https://demo.home-assistant.io`
+  - The `--web-url` doesn't necessarily need to be a Home Assistant url, any kind of website can be shown in kiosk mode.
+  - Only when using the MQTT integration via `--mqtt-*`, a running Home Assistant instance is required.
+- If you need the application to be automatically started on boot, create a systemd file.
+
+#### Option 3 - The hard way
+Pre-built release files are available for arm64 and x64 Linux systems.
+If you are using a different architecture, you can still utilize this repository to build your own application.
+
+For more information please refer to the [development](https://github.com/leukipp/touchkio?tab=readme-ov-file#development) section, however this will do the job:
+```bash
+yarn build
+```
+
+</div></details>
+
+#### Update
+If you have already installed TouchKio and want to upgrade to the latest version, simply install the newer version over the existing one.
+
+The [install.sh](https://github.com/leukipp/touchkio/blob/main/install.sh) script can also be run to update an existing installation to the **latest version**.
+The setup procedure can be skipped to use the existing default arguments from the configuration file:
+```bash
+bash <(wget -qO- https://raw.githubusercontent.com/leukipp/touchkio/main/install.sh) update
+```

 ## Configuration
 Running `touchkio --setup` will prompt you to enter arguments that will be used when the application starts without any specified arguments.
@@ -63,16 +114,31 @@ These default arguments are stored in `~/.config/touchkio/Arguments.json`, where
 ### WEB
 The available arguments to control the kiosk application via terminal are as follows:
 | Name                      | Default | Description                                                                                                |
-| ------------------------ | ------- | ------------------------------------------------------ |
-| `--web-url` (Required)   | -       | Url of the Home Assistant instance (HTTP(S)://IP:PORT) |
+| ------------------------- | ------- | ---------------------------------------------------------------------------------------------------------- |
+| `--web-url` (Required)    | -       | Url of the Home Assistant instance<a id="ref1"></a><sup><a href="#foot1">[1]</a></sup> (HTTP(S)://IP:PORT) |
 | `--web-theme` (Optional)  | `dark`  | Theme settings of the web browser (`light` or `dark`)                                                      |
 | `--web-zoom` (Optional)   | `1.25`  | Zoom settings of the web browser (`1.0` is `100%`)                                                         |
+| `--web-widget` (Optional) | `true`  | Enables the sidebar widget (`true` or `false`)                                                             |

-These arguments allow you to customize the appearance of the web browser window.
+These arguments allow you to customize the appearance of the web browser view.

 For example:
 ```bash
-touchkio --web-url=http://192.168.1.42:8123 --web-theme=dark --web-zoom=1.25
+touchkio --web-url=http://192.168.1.42:8123 --web-theme=light --web-zoom=1.0
+```
+
+> <a id="foot1"></a><a href="#ref1">[1]</a>: This doesn't necessarily have to be a Home Assistant Url.
+> You can configure multiple pages by separating them with a comma:
+> `touchkio --web-url=https://demo.home-assistant.io,https://demo.immichkiosk.app`.
+
+In the `~/.config/touchkio/Arguments.json` file:
+```json
+{
+  "web_url": [
+    "https://demo.home-assistant.io",
+    "https://demo.immichkiosk.app"
+  ]
+}
 ```

 ### MQTT
@@ -85,51 +151,109 @@ To broadcast your local sensor data to Home Assistant, you can use the following
 | `--mqtt-discovery` (Optional) | `homeassistant` | The discovery prefix for MQTT (`homeassistant` works with default setups)                |

 When you start the application with the MQTT arguments, the Home Assistant auto-discovery feature will automatically add controls and sensors that can be used for further integration.
-You can find them under **Settings** -> **Devices and Services** -> **Devices** by searching for "Raspberry Pi".
+You can find them under **Settings** -> **Devices and Services** -> **Devices** by searching for **TouchKio**.

 For example:
 ```bash
 touchkio --web-url=http://192.168.1.42:8123 --mqtt-url=mqtt://192.168.1.42:1883 --mqtt-user=kiosk --mqtt-password=password
 ```

+## User Interface
+TouchKio provides a simple webview window designed specifically for Touch Displays. Electron apps are known to be resource intensive due to their architecture and the inclusion of a full web browser environment. If you just run the kiosk application without other heavy loads, everything should run smoothly.
+
+### Touch Controls
+Additional controls can be found along the right edge of the kiosk application. For more details, you may want to have a closer look here:
+| Name         | Description                                              |
+| ------------ | -------------------------------------------------------- |
+| `Widget`     | [See #16](https://github.com/leukipp/touchkio/issues/16) |
+| `Navigation` | [See #45](https://github.com/leukipp/touchkio/issues/45) |
+| `Pager`      | [See #64](https://github.com/leukipp/touchkio/issues/64) |
+
+
+### Keyboard Shortcuts
+The application also supports basic shortcuts to enhance navigation and usability for users who prefer or require non-touch input methods:
+| Name                        | Description                  |
+| --------------------------- | ---------------------------- |
+| `Control+Left`              | Navigate to previous page    |
+| `Control+Right`             | Navigate to next page        |
+| `Control+Num_Subtract`      | Decrease the page zoom       |
+| `Control+Num_Add`           | Increase the page zoom       |
+| `Alt+Left`/`Mouse+Back`     | Navigate backward in history |
+| `Alt+Right`/`Mouse+Forward` | Navigate forward in history  |
+
 ## Development
-If you want to create your own local build install [nodejs](https://pimylifeup.com/raspberry-pi-nodejs) and [yarn](https://classic.yarnpkg.com/lang/en/docs/install) on your Raspberry Pi.
+To create your own local build, you first need to install [Node.js](https://pimylifeup.com/raspberry-pi-nodejs) and [Yarn](https://classic.yarnpkg.com/lang/en/docs/install).

 Clone this repository and run `yarn install` to install the dependencies.
-Then use `yarn start` to execute the `start` script located in the [package.json](https://github.com/leukipp/touchkio/blob/main/package.json) file.
-There you can adjust the `--web-url` and other arguments for development runs.
+Then use `yarn start` to execute the start script located in the [package.json](https://github.com/leukipp/touchkio/blob/main/package.json) file.
+There you may want to adjust the `--web-url` and other arguments for development runs.

-If you connect to your Raspberry Pi via SSH, you must export the display variables so that the kiosk application can be loaded in the desktop environment:
+If you access your device over SSH, make sure to export the display variables so the kiosk application can launch in the desktop environment.
 ```bash
 export DISPLAY=":0"
 export WAYLAND_DISPLAY="wayland-0"
 ```
+To make this permanent, consider adding the export variables into the `~/.bashrc` file.
+
+### Extensions
+
+<details><summary>You probably won't need this.</summary><div></br>
+
+Incorporating custom extensions and external hardware (like motion sensors, ultrasonic sensors, cameras, relays and switches) via **Raspberry Pi's GPIO/USB** involves several steps.
+While using external sensors that directly integrate with Home Assistant and by utilizing automation's to interact with **TouchKio via MQTT** is generally easier and **recommended**, here's a rough guide on how to proceed with custom hardware integration:
+
+1. **Install Node.js library**: Use Yarn to add a library that can interact with your hardware (GPIO, USB, etc.):
+    ```bash
+    yarn add [package-name]
+    ```
+    This will update the `package.json` file with the required dependencies.
+
+2. **Import the library**: Open the `hardware.js` file and import the library using:
+    ```javascript
+    const package = require("[package-name]");
+    ```
+    Then implement your custom methods and logic to handle the hardware. Don't forget to export the methods at the end of the file:
+    ```javascript
+    module.exports = { ... };
+    ```
+
+3. **Expose sensors via MQTT**: If you want to publish sensor data through MQTT, implement some init and update methods in the `integration.js` file:
+    ```javascript
+    const initCustomSensor = (client) => { ... }
+    const updateCustomSensor = (client) => { ... }
+    ```
+    To get started have a look at the existing methods. Don't forget to call the custom sensor initialization method inside the global init method, where the MQTT connection is established:
+    ```javascript
+    const init = async (args) => { ... }
+    ```
+    From there, you will need to further refine your code by tinkering with sensor updates. This can be achieved through either periodic update calls or event based triggers.
+
+</div></details>

 ### The nitty gritty

 <details><summary>Don't waste your time reading this.</summary><div></br>

-To enable **write access** to the `/sys/class/backlight/10-0045/bl_power` and `/sys/class/backlight/10-0045/brightness` files, you need to set up a **udev rule**. In case you don't use the official touch display you may have to change the rules, that are located under `/etc/udev/rules.d/backlight-permissions.rules`.
-
-This rule is created via the [install.sh](https://github.com/leukipp/touchkio/blob/main/install.sh) script, which also creates a service file.
-The service file is located at `~/.config/systemd/user/touchkio.service` and starts the `/usr/bin/touchkio` process when the graphical user interface is loaded.
-While creating a service file is optional, it's highly recommended if you want your Raspberry Pi to automatically boot into kiosk mode.
+The Raspberry Pi's **build-in on-screen keyboard** named `squeekboard` (it squeaks because some _Rust_ got inside), is specifically designed for Wayland environments and features a **D-Bus interface** that allows applications to show or hide the keyboard as needed.
+The kiosk application interacts with squeekboard via the `D-Bus` object path `/sm/puri/OSK0`, enabling the keyboard to be hidden or shown based on **MQTT** user input or system events.

 The Raspberry Pi's **build-in screen blanking** function uses the command `swayidle -w timeout 600 'wlopm --off \*' resume 'wlopm --on \*' &` inside `~/.config/labwc/autostart` to blank the screen after **10 minutes**.
-The `wlopm --off \*` command changes the `bl_power` value to **4**, when setting the value to **0** the screen will turn on again.
+The `wlopm --off \*` command changes the `/sys/class/backlight/*/bl_power` value to **4**, when setting the value to **0** the screen will turn on again.
 However, `swayidle` still seems to consider the screen to be off and as a result it will not turn off again unless there is some interaction in the meantime.

 When using the MQTT integration, the kiosk application must be able to **detect changes** made on the **device** itself.
-I managed to achieve this for the `brightness` file by implementing a simple `fs.watch(..)` file listener.
-However, I found that it **never triggered** for the `bl_power` file.
+I managed to achieve this for the `/sys/class/backlight/*/brightness` file by implementing a simple `fs.watch(..)` file listener.
+However, I found that it **never triggered** for the `/sys/class/backlight/*/bl_power` or the `/sys/class/drm/*/dpms` file.
 Although the file content changes, none of the filesystem listeners where fired.
 This could be due to `swayidle`/`wlopm` performing write actions at a deeper level that are not detectable by file listeners.
-As a result, I went for a **polling solution**, checking the state of the file every **500 milliseconds** for any changes.
+
+As a result, I went for a **polling solution**, checking the state of the `/sys/class/backlight/*/brightness` and `/sys/class/drm/*/dpms` file **every second** for any changes.
+In case `ddcutil` is installed the file `~/.config/touchkio/Cache/Brightness.vcp` will be written/monitored to support brightness support for HDMI screens.
 While I understand this is not ideal, it's necessary to ensure proper functionality.

 The display power status and brightness can be adjusted via the MQTT integration.
-**Support** for changing the power status for **DSI and HDMI** displays is achieved by checking for connected screens in `/sys/class/drm/*/status`.
-Support for changing the brightness of connected display is implemented by using `/sys/class/backlight/*/brightness`.
+**Support** for changing the power status on **DSI and HDMI** displays is achieved by checking for connected screens in `/sys/class/drm/*/status`.
+Support for changing the brightness of a connected display is implemented by using `sudo tee /sys/class/backlight/*/brightness` or `sudo ddcutil setvcp 10`.
 In cases where no supported backlight device is found, the Home Assistant light entity will only show an on/off switch without brightness control.

 Keep in mind that default arguments are stored as plain text in `~/.config/touchkio/Arguments.json`.
@@ -138,31 +262,55 @@ Implementing stronger **security measures** would complicate the setup process a
 When using the kiosk application without initializing the default arguments, you will need to provide them with every command.
 This means that the password may be stored as plain text in various files, such as `touchkio.service`, `~/.bash_history`, etc.

-To resolve the issue where the first **touch** on a **turned-off screen** triggers a **click event** (potentially activating Home Assistant actions), I implemented a workaround.
-When the screen **turns off** the **focus** is removed from the kiosk window.
-This way, the first click only turns the screen on and focuses the window, allowing subsequent clicks to work as expected.
+To address the problem where the first **touch** on a **turned-off screen** may trigger a **click event** (which could inadvertently activate Home Assistant actions), a workaround needed to be implemented.
+When the screen **turns on/off**, the timestamps of these events are recorded.
+If a touch event is detected and the **timestamp** of the **last screen-off** is more recent than the **last screen-on** timestamp, the touch event is discarded and the screen is turned on instead.
+From that point onward, subsequent touch interactions will function normally as expected.

-Additionally, to address the problem that scrolling on the Raspberry Pi only works with the **web browser scrollbar** on the right, the Electron app is configured to **simulate a touch device** using `Emulation.setEmitTouchEventsForMouse`.
+Additionally, to address the problem that scrolling only works with the **web browser scrollbar** on the right, the application is configured to **simulate a touch device** using `Emulation.setEmitTouchEventsForMouse`.
 This adjustment provides a user experience similar to that of a proper mobile device.

-Electron apps are known to be **resource intensive** due to their architecture and the inclusion of a full web browser environment. If you just run the kiosk application without other heavy loads, everything should run smoothly.
-
 </div></details>

 ## Issues
-Please have a look into the [hardware](https://github.com/leukipp/touchkio/blob/main/HARDWARE.md) documentation if you ran into any issues. 
+> [!NOTE]
+> ### Please read the hardware [FAQ](https://github.com/leukipp/touchkio/blob/main/HARDWARE.md#faq) section first if you encounter any issues.

- Depending on the display hardware you are using, some features of the MQTT integration may not fully work (e.g. display brightness control).
-  - This is especially common when using X11 instead of Wayland (default on Raspberry Pi OS).
- You can use Raspberry Pi's build-in screen blanking functionality, however, if the screen is turned on through Home Assistant after being automatically turned off, it will remain on indefinitely.
-  - It's recommended to either use the built-in screen blanking feature or implement a Home Assistant automation (e.g. presence detection) to manage the screen status.
- Hyperlinks that redirect the browser away from the main window are intentionally disabled.
-  - This decision was made to maintain a clean design, as navigation buttons to move back and forth between different sites were not included.
- On the Raspberry Pi terminal you may see some *ERROR:gbm_wrapper.cc* messages.
-  -  This appears to be a [known issue](https://github.com/electron/electron/issues/42322) that currently lacks a fix, but the webview still works.
+For basic debugging **(TouchKio)**, stop the service and launch `touchkio` directly on the terminal to monitor the log output in real-time.
+This output is also written into `~/.config/touchkio/logs/main.log` for review.
+
+For extended logging **(Electron)** you can run `touchkio --enable-logging`, which will write an additional log file into `~/.config/touchkio/logs/electron.log`.
+Refer to the [--log-level=[0-3]](https://www.electronjs.org/docs/latest/api/command-line-switches#--log-leveln) and [--v=[0-3]](https://www.electronjs.org/docs/latest/api/command-line-switches#--vlog_level) options to adjust the logging verbosity.
+
+If you need to debug the webview **(Chrome DevTools)** use `touchkio --app-debug`.
+
+In case [undocumented problems](https://github.com/leukipp/touchkio/blob/main/HARDWARE.md#faq) arise, please [create an issue](https://github.com/leukipp/touchkio/issues) and include the output of `touchkio --version`, additional information about your system (such as operating system, hardware, etc.), and any relevant log files.

 ## Credits
-Inspired by the one and only Raspberry Pi Master Lord, [Jeff Geerling](https://www.jeffgeerling.com/blog/2024/home-assistant-and-carplay-pi-touch-display-2).
+[Inspired by](https://www.jeffgeerling.com/blog/2024/home-assistant-and-carplay-pi-touch-display-2) the one and only Raspberry Pi Master, Jeff Geerling ([@geerlingguy](https://github.com/geerlingguy)).
+
+Thanks to Sebastian ([@pdsccode](https://github.com/pdsccode)) for his contributions on issues and [community](https://community.home-assistant.io/t/kiosk-mode-for-raspberry-pi-with-touch-display/821196) discussions.
+
+### Tutorials
+If you are looking for hardware or a well-designed mounting solution for the Raspberry Pi Display, check out the [blog post](https://www.thestockpot.net/videos/home-assistant-wall-display) from Dillan Stock ([@TheStockPot-AU](https://www.youtube.com/@TheStockPot-AU)):
+
+<a href="https://www.youtube.com/watch?v=uTxURzmrVtA">
+  <img src="https://img.youtube.com/vi/uTxURzmrVtA/maxresdefault.jpg" alt="What My Smart Home Was Missing" title="@TheStockPot-AU" style="width:100%">
+</a>
+
+Also, have a look at this curated collection of helpful videos contributed by the community:
+
+<p align="center" style="width:100%">
+  <a href="https://www.youtube.com/watch?v=_adl1fiXlgk">
+    <img src="https://img.youtube.com/vi/_adl1fiXlgk/mqdefault.jpg" alt="Building a Home Assistant Kiosk - Why Did I Wait So Long?" title="@Jims-Garage" style="width:32%">
+  </a>
+  <a href="https://www.youtube.com/watch?v=uXcjx-zL_UU">
+    <img src="https://img.youtube.com/vi/uXcjx-zL_UU/mqdefault.jpg" alt="Touch Display for Home Assistant with TouchKIO" title="@haus_automation" style="width:32%">
+  </a>
+  <a href="https://www.youtube.com/watch?v=t2YQm7GPmpY">
+    <img src="https://img.youtube.com/vi/t2YQm7GPmpY/mqdefault.jpg" alt="DIY Home Assistant Kiosk Build: Raspberry Pi & 3D Printing Livestream" title="@homeautomatorza" style="width:32%">
+  </a>
+</p>

 ## License
 [MIT](https://github.com/leukipp/touchkio/blob/main/LICENSE)
@@ -0,0 +1,85 @@
+const fs = require("fs");
+const jszip = require("jszip");
+const crypto = require("crypto");
+const path = require("path");
+
+const date = new Date().toISOString();
+
+const generateBuildFile = (platform, arch, maker) => {
+  const package = fs.readFileSync(path.join(__dirname, "package.json"), "utf8");
+  const hash = crypto.createHash("sha256").update(package);
+  const data = {
+    id: hash.digest("hex").slice(-6),
+    platform: platform,
+    arch: arch,
+    maker: maker,
+    date: date,
+  };
+  return JSON.stringify(data, null, 2);
+};
+
+module.exports = {
+  packagerConfig: {
+    ignore: [".github", ".gitignore", "install.sh", "forge.config.js"],
+  },
+  makers: [
+    {
+      name: "@electron-forge/maker-deb",
+      config: {
+        options: {
+          productName: "TouchKio",
+          productDescription: "Kiosk mode application for a Home Assistant dashboard",
+          categories: ["Network"],
+          icon: "img/icon.png",
+        },
+      },
+    },
+    {
+      name: "@electron-forge/maker-zip",
+    },
+  ],
+  publishers: [
+    {
+      name: "@electron-forge/publisher-github",
+      config: {
+        repository: {
+          owner: "leukipp",
+          name: "touchkio",
+        },
+        draft: true,
+      },
+    },
+  ],
+  hooks: {
+    postPackage: async (config, results) => {
+      for (const outputPath of results.outputPaths) {
+        const [name, platform, arch] = path.basename(outputPath).split("-");
+        const buildFile = path.join(outputPath, "resources", "app", "build.json");
+        fs.writeFileSync(buildFile, generateBuildFile(platform, arch, "deb"), { encoding: "utf8" });
+      }
+    },
+    postMake: async (config, results) => {
+      for (const result of results) {
+        const artifacts = [];
+        for (const artifact of result.artifacts) {
+          if (artifact.includes(".zip")) {
+            const [name, platform, arch] = path.basename(artifact).split("-");
+            const buildFile = path.join(`${name}-${platform}-${arch}`, "resources", "app", "build.json");
+            const options = { type: "nodebuffer", compression: "DEFLATE", compressionOptions: { level: 9 } };
+            const zip = await jszip.loadAsync(fs.readFileSync(artifact));
+            zip.file(buildFile, generateBuildFile(platform, arch, "zip"));
+            fs.writeFileSync(artifact, await zip.generateAsync(options));
+          }
+          if (artifact.includes("amd64")) {
+            const renamed = artifact.replace("amd64", "x64");
+            fs.renameSync(artifact, renamed);
+            artifacts.push(renamed);
+          } else {
+            artifacts.push(artifact);
+          }
+        }
+        result.artifacts = artifacts;
+      }
+    },
+  },
+};
@@ -0,0 +1,237 @@
+<!doctype html>
+<html>
+  <head>
+    <meta http-equiv="Content-Security-Policy" content="default-src 'unsafe-inline'" />
+    <style>
+      [data-theme="dark"] {
+        --primary-color: rgba(225, 225, 225, 1);
+        --border-color: rgba(225, 225, 225, 0.15);
+        --background-color: rgba(28, 28, 28, 1);
+      }
+      [data-theme="light"] {
+        --primary-color: rgba(33, 33, 33, 1);
+        --border-color: rgba(33, 33, 33, 0.15);
+        --background-color: rgba(255, 255, 255, 1);
+      }
+      ::-webkit-scrollbar {
+        display: none;
+      }
+      * {
+        margin: 0;
+        padding: 0;
+        cursor: pointer;
+      }
+      body {
+        display: flex;
+        align-items: center;
+        width: 100vw;
+        height: 100vh;
+      }
+      menu {
+        display: flex;
+        flex-direction: row;
+        align-items: center;
+        width: 100vw;
+        height: 100vh;
+        padding: 0 10px;
+        column-gap: 10px;
+        list-style-type: none;
+        border-top: 1px solid var(--border-color);
+        background: var(--background-color);
+      }
+      li {
+        display: flex;
+        align-items: center;
+        flex: 0 0 auto;
+      }
+      li.dynamic {
+        flex: 1 1 0%;
+      }
+      li.separator {
+        height: 32px;
+        border: 1px solid var(--border-color);
+      }
+      li.separator:has(+ li.hidden) {
+        display: none;
+      }
+      li.hidden {
+        display: none;
+      }
+      li.disabled {
+        opacity: 0.5;
+        cursor: not-allowed;
+        pointer-events: none;
+      }
+      button {
+        width: 32px;
+        height: 32px;
+        border: none;
+        background-color: transparent;
+      }
+      input {
+        width: 100%;
+        min-width: 0;
+        margin: 0 5px;
+        padding: 6px 10px;
+        border-radius: 4px;
+        font-size: 18px;
+        font-family: sans-serif;
+        outline: none;
+        border: none;
+        cursor: text;
+        box-sizing: border-box;
+        color: var(--primary-color);
+        background-color: var(--border-color);
+      }
+      svg {
+        pointer-events: none;
+        fill: var(--primary-color);
+      }
+    </style>
+  </head>
+  <body>
+    <menu>
+      <li>
+        <button id="home">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+            <title>home-circle</title>
+            <path
+              d="M19.07,4.93C17.22,3 14.66,1.96 12,2C9.34,1.96 6.79,3 4.94,4.93C3,6.78 1.96,9.34 2,12C1.96,14.66 3,17.21 4.93,19.06C6.78,21 9.34,22.04 12,22C14.66,22.04 17.21,21 19.06,19.07C21,17.22 22.04,14.66 22,12C22.04,9.34 21,6.78 19.07,4.93M17,12V18H13.5V13H10.5V18H7V12H5L12,5L19.5,12H17Z"
+            />
+          </svg>
+        </button>
+      </li>
+      <li>
+        <button id="refresh">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+            <title>refresh-circle</title>
+            <path
+              d="M12 2A10 10 0 1 0 22 12A10 10 0 0 0 12 2M18 11H13L14.81 9.19A3.94 3.94 0 0 0 12 8A4 4 0 1 0 15.86 13H17.91A6 6 0 1 1 12 6A5.91 5.91 0 0 1 16.22 7.78L18 6Z"
+            />
+          </svg>
+        </button>
+      </li>
+      <li class="separator"></li>
+      <li>
+        <button id="previous">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+            <title>page-previous</title>
+            <path
+              d="M4,21H19A2,2 0 0,0 21,19V13H17V15L13,12L17,9V11H21V5A2,2 0 0,0 19,3H4A2,2 0 0,0 2,5V19A2,2 0 0,0 4,21M4,15H8V17H4V15M4,11H11V13H4V11M4,7H11V9H4V7M21,11H24V13H21V11Z"
+            />
+          </svg>
+        </button>
+      </li>
+      <li>
+        <button id="next">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+            <title>page-next</title>
+            <path
+              d="M20,3H5A2,2 0 0,0 3,5V11H7V9L11,12L7,15V13H3V19A2,2 0 0,0 5,21H20A2,2 0 0,0 22,19V5A2,2 0 0,0 20,3M17,17H13V15H17V17M20,13H13V11H20V13M20,9H13V7H20V9M3,13H0V11H3V13Z"
+            />
+          </svg>
+        </button>
+      </li>
+      <li class="separator"></li>
+      <li class="dynamic">
+        <input id="url" type="text" spellcheck="false" readonly="true" />
+      </li>
+      <li class="separator"></li>
+      <li>
+        <button id="backward">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+            <title>history</title>
+            <path
+              d="M13.5,8H12V13L16.28,15.54L17,14.33L13.5,12.25V8M13,3A9,9 0 0,0 4,12H1L4.96,16.03L9,12H6A7,7 0 0,1 13,5A7,7 0 0,1 20,12A7,7 0 0,1 13,19C11.07,19 9.32,18.21 8.06,16.94L6.64,18.36C8.27,20 10.5,21 13,21A9,9 0 0,0 22,12A9,9 0 0,0 13,3"
+            />
+          </svg>
+        </button>
+      </li>
+      <li>
+        <button id="forward">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+            <title>update</title>
+            <path
+              d="M21,10.12H14.22L16.96,7.3C14.23,4.6 9.81,4.5 7.08,7.2C4.35,9.91 4.35,14.28 7.08,17C9.81,19.7 14.23,19.7 16.96,17C18.32,15.65 19,14.08 19,12.1H21C21,14.08 20.12,16.65 18.36,18.39C14.85,21.87 9.15,21.87 5.64,18.39C2.14,14.92 2.11,9.28 5.62,5.81C9.13,2.34 14.76,2.34 18.27,5.81L21,3V10.12M12.5,8V12.25L16,14.33L15.28,15.54L11,13V8H12.5Z"
+            />
+          </svg>
+        </button>
+      </li>
+      <li class="separator"></li>
+      <li>
+        <button id="minus">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+            <title>magnify-minus</title>
+            <path
+              d="M9,2A7,7 0 0,1 16,9C16,10.57 15.5,12 14.61,13.19L15.41,14H16L22,20L20,22L14,16V15.41L13.19,14.61C12,15.5 10.57,16 9,16A7,7 0 0,1 2,9A7,7 0 0,1 9,2M5,8V10H13V8H5Z"
+            />
+          </svg>
+        </button>
+      </li>
+      <li>
+        <button id="plus">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+            <title>magnify-plus</title>
+            <path
+              d="M9,2A7,7 0 0,1 16,9C16,10.57 15.5,12 14.61,13.19L15.41,14H16L22,20L20,22L14,16V15.41L13.19,14.61C12,15.5 10.57,16 9,16A7,7 0 0,1 2,9A7,7 0 0,1 9,2M8,5V8H5V10H8V13H10V10H13V8H10V5H8Z"
+            />
+          </svg>
+        </button>
+      </li>
+    </menu>
+    <script>
+      const { ipcRenderer } = require("electron");
+
+      const registerSendEvents = () => {
+        document.querySelectorAll("button").forEach((button) => {
+          button.addEventListener("click", (e) => {
+            ipcRenderer.send("button-click", { id: e.target.id });
+          });
+        });
+        document.querySelectorAll("input").forEach((input) => {
+          input.addEventListener("blur", (e) => {
+            ipcRenderer.send("input-blur", { id: e.target.id });
+          });
+          input.addEventListener("focus", (e) => {
+            ipcRenderer.send("input-focus", { id: e.target.id });
+          });
+          input.addEventListener("keydown", (e) => {
+            if (e.key === "Enter") {
+              ipcRenderer.send("input-enter", { id: e.target.id, text: e.target.value });
+            }
+          });
+        });
+      };
+
+      const registerReceiveEvents = () => {
+        ipcRenderer.on("button-disabled", (e, button) => {
+          document.getElementById(button.id).parentNode.classList.toggle("disabled", button.disabled);
+        });
+        ipcRenderer.on("button-hidden", (e, button) => {
+          document.getElementById(button.id).parentNode.classList.toggle("hidden", button.hidden);
+        });
+        ipcRenderer.on("input-readonly", (e, input) => {
+          document.getElementById(input.id).readOnly = input.readonly;
+        });
+        ipcRenderer.on("input-text", (e, input) => {
+          document.getElementById(input.id).value = input.text;
+          document.getElementById(input.id).placeholder = input.placeholder;
+        });
+        ipcRenderer.on("input-select", (e, input) => {
+          window.getSelection()?.removeAllRanges();
+          if (input.select) {
+            document.getElementById(input.id).select();
+          } else {
+            document.getElementById(input.id).blur();
+          }
+        });
+        ipcRenderer.on("data-theme", (e, data) => {
+          document.documentElement.setAttribute("data-theme", data.theme);
+        });
+      };
+
+      registerSendEvents();
+      registerReceiveEvents();
+    </script>
+  </body>
+</html>
@@ -0,0 +1,103 @@
+<!doctype html>
+<html>
+  <head>
+    <meta http-equiv="Content-Security-Policy" content="default-src 'unsafe-inline'" />
+    <style>
+      [data-theme="dark"] {
+        --background-color: rgba(225, 225, 225, 0.15);
+        --previous-cursor: w-resize;
+        --next-cursor: e-resize;
+      }
+      [data-theme="light"] {
+        --background-color: rgba(33, 33, 33, 0.15);
+        --previous-cursor: w-resize;
+        --next-cursor: e-resize;
+      }
+      [data-theme="hidden"] {
+        --background-color: rgba(0, 0, 0, 0);
+        --previous-cursor: none;
+        --next-cursor: none;
+      }
+      ::-webkit-scrollbar {
+        display: none;
+      }
+      * {
+        margin: 0;
+        padding: 0;
+        cursor: none;
+      }
+      body {
+        display: flex;
+        align-items: center;
+        width: 100vw;
+        height: 100vh;
+      }
+      menu {
+        display: flex;
+        flex-direction: column;
+        align-items: center;
+        width: 100vw;
+        height: 100vh;
+        list-style-type: none;
+      }
+      li {
+        display: flex;
+        align-items: center;
+        flex: 0 0 auto;
+      }
+      li:not(.disabled) #previous {
+        cursor: var(--previous-cursor);
+      }
+      li:not(.disabled) #next {
+        cursor: var(--next-cursor);
+      }
+      button {
+        width: 100vw;
+        height: 50vh;
+        border: none;
+        cursor: not-allowed;
+        background-color: transparent;
+      }
+      button:not(:active) {
+        transition: background-color 500ms step-end;
+      }
+      menu:has(button:active) button {
+        background-color: var(--background-color);
+        transition-duration: 0ms;
+      }
+    </style>
+  </head>
+  <body>
+    <menu>
+      <li>
+        <button id="previous"></button>
+      </li>
+      <li>
+        <button id="next"></button>
+      </li>
+    </menu>
+    <script>
+      const { ipcRenderer } = require("electron");
+
+      const registerSendEvents = () => {
+        document.querySelectorAll("button").forEach((button) => {
+          button.addEventListener("pointerdown", (e) => {
+            ipcRenderer.send("button-click", { id: e.target.id });
+          });
+        });
+      };
+
+      const registerReceiveEvents = () => {
+        ipcRenderer.on("button-disabled", (e, button) => {
+          document.getElementById(button.id).parentNode.classList.toggle("disabled", button.disabled);
+        });
+        ipcRenderer.on("data-theme", (e, data) => {
+          document.documentElement.setAttribute("data-theme", data.theme);
+        });
+      };
+
+      registerSendEvents();
+      registerReceiveEvents();
+    </script>
+  </body>
+</html>
@@ -0,0 +1,162 @@
+<!doctype html>
+<html>
+  <head>
+    <meta http-equiv="Content-Security-Policy" content="default-src 'unsafe-inline'" />
+    <style>
+      [data-theme="dark"] {
+        --primary-color: rgba(229, 229, 229, 1);
+        --background-color: rgba(66, 67, 68, 1);
+        --minimize-color: rgba(52, 199, 89, 1);
+        --fullscreen-color: rgba(255, 149, 0, 1);
+        --terminate-color: rgba(255, 59, 48, 1);
+      }
+      [data-theme="light"] {
+        --primary-color: rgba(26, 26, 26, 1);
+        --background-color: rgba(237, 236, 235, 1);
+        --minimize-color: rgba(52, 199, 89, 1);
+        --fullscreen-color: rgba(255, 149, 0, 1);
+        --terminate-color: rgba(255, 59, 48, 1);
+      }
+      ::-webkit-scrollbar {
+        display: none;
+      }
+      * {
+        margin: 0;
+        padding: 0;
+        cursor: pointer;
+      }
+      body {
+        display: flex;
+        align-items: center;
+        width: 100vw;
+        height: 100vh;
+        background: var(--background-color);
+      }
+      header {
+        display: flex;
+        align-items: center;
+        flex: 1 1 0%;
+        height: 100vh;
+        -webkit-app-region: drag;
+      }
+      h1 {
+        position: absolute;
+        transform: translate(-50%, -50%);
+        top: 50%;
+        left: 50%;
+        font-size: 18px;
+        font-weight: 500;
+        font-family: sans-serif;
+        overflow: hidden;
+        white-space: nowrap;
+        text-overflow: ellipsis;
+        text-align: center;
+        user-select: none;
+        color: var(--primary-color);
+      }
+      menu {
+        display: flex;
+        flex-direction: row;
+        align-items: center;
+        flex: 0 0 auto;
+        height: 100vh;
+        min-width: 116px;
+        padding: 0px 10px;
+        column-gap: 10px;
+        list-style-type: none;
+        background: var(--background-color);
+        position: relative;
+        z-index: 1;
+      }
+      li {
+        display: flex;
+        align-items: center;
+        flex: 0 0 auto;
+      }
+      li.disabled {
+        opacity: 0.5;
+        cursor: not-allowed;
+        pointer-events: none;
+      }
+      button {
+        width: 32px;
+        height: 32px;
+        border: none;
+        background-color: transparent;
+      }
+      svg {
+        pointer-events: none;
+      }
+      #minimize > svg {
+        fill: var(--minimize-color);
+      }
+      #fullscreen > svg {
+        fill: var(--fullscreen-color);
+      }
+      #terminate > svg {
+        fill: var(--terminate-color);
+      }
+    </style>
+  </head>
+  <body>
+    <header>
+      <h1 id="title">TouchKio</h1>
+    </header>
+    <menu>
+      <li>
+        <button id="minimize">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+            <title>minus-circle</title>
+            <path d="M17,13H7V11H17M12,2A10,10 0 0,0 2,12A10,10 0 0,0 12,22A10,10 0 0,0 22,12A10,10 0 0,0 12,2Z" />
+          </svg>
+        </button>
+      </li>
+      <li>
+        <button id="fullscreen">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+            <title>chevron-up-circle</title>
+            <path
+              d="M22,12A10,10 0 0,1 12,22A10,10 0 0,1 2,12A10,10 0 0,1 12,2A10,10 0 0,1 22,12M7.4,15.4L12,10.8L16.6,15.4L18,14L12,8L6,14L7.4,15.4Z"
+            />
+          </svg>
+        </button>
+      </li>
+      <li>
+        <button id="terminate">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+            <title>close-circle</title>
+            <path
+              d="M12,2C17.53,2 22,6.47 22,12C22,17.53 17.53,22 12,22C6.47,22 2,17.53 2,12C2,6.47 6.47,2 12,2M15.59,7L12,10.59L8.41,7L7,8.41L10.59,12L7,15.59L8.41,17L12,13.41L15.59,17L17,15.59L13.41,12L17,8.41L15.59,7Z"
+            />
+          </svg>
+        </button>
+      </li>
+    </menu>
+    <script>
+      const { ipcRenderer } = require("electron");
+
+      const registerSendEvents = () => {
+        document.querySelectorAll("button").forEach((button) => {
+          button.addEventListener("click", (e) => {
+            ipcRenderer.send("button-click", { id: e.target.id });
+          });
+        });
+      };
+
+      const registerReceiveEvents = () => {
+        ipcRenderer.on("button-disabled", (e, button) => {
+          document.getElementById(button.id).parentNode.classList.toggle("disabled", button.disabled);
+        });
+        ipcRenderer.on("text-content", (e, text) => {
+          document.getElementById(text.id).textContent = text.content;
+        });
+        ipcRenderer.on("data-theme", (e, data) => {
+          document.documentElement.setAttribute("data-theme", data.theme);
+        });
+      };
+
+      registerSendEvents();
+      registerReceiveEvents();
+    </script>
+  </body>
+</html>
@@ -0,0 +1,137 @@
+<!doctype html>
+<html>
+  <head>
+    <meta http-equiv="Content-Security-Policy" content="default-src 'unsafe-inline'" />
+    <style>
+      [data-theme="dark"] {
+        --primary-color: rgba(225, 225, 225, 1);
+        --border-color: rgba(225, 225, 225, 0.15);
+        --background-color: rgba(28, 28, 28, 1);
+      }
+      [data-theme="light"] {
+        --primary-color: rgba(33, 33, 33, 1);
+        --border-color: rgba(33, 33, 33, 0.15);
+        --background-color: rgba(255, 255, 255, 1);
+      }
+      [data-theme="hidden"] {
+        --primary-color: rgba(0, 0, 0, 0);
+        --border-color: rgba(0, 0, 0, 0);
+        --background-color: rgba(0, 0, 0, 0);
+      }
+      ::-webkit-scrollbar {
+        display: none;
+      }
+      * {
+        margin: 0;
+        padding: 0;
+        cursor: pointer;
+      }
+      body {
+        display: flex;
+        align-items: center;
+        width: 100vw;
+        height: 100vh;
+      }
+      menu {
+        display: flex;
+        flex-direction: column;
+        align-items: center;
+        width: 100vw;
+        padding: 10px;
+        row-gap: 10px;
+        list-style-type: none;
+        border-top-left-radius: 15px;
+        border-bottom-left-radius: 15px;
+        border-top: 1px solid var(--border-color);
+        border-left: 1px solid var(--border-color);
+        border-bottom: 1px solid var(--border-color);
+        background: var(--background-color);
+      }
+      li {
+        display: flex;
+        align-items: center;
+        flex: 0 0 auto;
+      }
+      li.hidden {
+        display: none;
+      }
+      button {
+        width: 32px;
+        height: 32px;
+        border: none;
+        background-color: transparent;
+      }
+      svg {
+        pointer-events: none;
+        fill: var(--primary-color);
+      }
+    </style>
+  </head>
+  <body>
+    <menu>
+      <li>
+        <button id="fullscreen">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+            <title>overscan</title>
+            <path
+              d="M12 5.5L10 8H14L12 5.5M18 10V14L20.5 12L18 10M6 10L3.5 12L6 14V10M14 16H10L12 18.5L14 16M21 3H3C1.9 3 1 3.9 1 5V19C1 20.1 1.9 21 3 21H21C22.1 21 23 20.1 23 19V5C23 3.9 22.1 3 21 3M21 19H3V5H21V19Z"
+            />
+          </svg>
+        </button>
+      </li>
+      <li>
+        <button id="theme">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+            <title>compare</title>
+            <path
+              d="M19,3H14V5H19V18L14,12V21H19A2,2 0 0,0 21,19V5C21,3.89 20.1,3 19,3M10,18H5L10,12M10,3H5C3.89,3 3,3.89 3,5V19A2,2 0 0,0 5,21H10V23H12V1H10V3Z"
+            />
+          </svg>
+        </button>
+      </li>
+      <li>
+        <button id="keyboard">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+            <title>keyboard-close-outline</title>
+            <path
+              d="M12 23L16 19H8M4 3C2.9 3 2 3.9 2 5V15C2 16.1 2.9 17 4 17H20C21.1 17 22 16.1 22 15V5C22 3.9 21.1 3 20 3H4M4 5H20V15H4V5M5 6V8H7V6H5M8 6V8H10V6H8M11 6V8H13V6H11M14 6V8H16V6H14M17 6V8H19V6H17M5 9V11H7V9H5M8 9V11H10V9H8M11 9V11H13V9H11M14 9V11H16V9H14M17 9V11H19V9H17M8 12V14H16V12H8Z"
+            />
+          </svg>
+        </button>
+      </li>
+      <li>
+        <button id="navigation">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+            <title>web</title>
+            <path
+              d="M16.36,14C16.44,13.34 16.5,12.68 16.5,12C16.5,11.32 16.44,10.66 16.36,10H19.74C19.9,10.64 20,11.31 20,12C20,12.69 19.9,13.36 19.74,14M14.59,19.56C15.19,18.45 15.65,17.25 15.97,16H18.92C17.96,17.65 16.43,18.93 14.59,19.56M14.34,14H9.66C9.56,13.34 9.5,12.68 9.5,12C9.5,11.32 9.56,10.65 9.66,10H14.34C14.43,10.65 14.5,11.32 14.5,12C14.5,12.68 14.43,13.34 14.34,14M12,19.96C11.17,18.76 10.5,17.43 10.09,16H13.91C13.5,17.43 12.83,18.76 12,19.96M8,8H5.08C6.03,6.34 7.57,5.06 9.4,4.44C8.8,5.55 8.35,6.75 8,8M5.08,16H8C8.35,17.25 8.8,18.45 9.4,19.56C7.57,18.93 6.03,17.65 5.08,16M4.26,14C4.1,13.36 4,12.69 4,12C4,11.31 4.1,10.64 4.26,10H7.64C7.56,10.66 7.5,11.32 7.5,12C7.5,12.68 7.56,13.34 7.64,14M12,4.03C12.83,5.23 13.5,6.57 13.91,8H10.09C10.5,6.57 11.17,5.23 12,4.03M18.92,8H15.97C15.65,6.75 15.19,5.55 14.59,4.44C16.43,5.07 17.96,6.34 18.92,8M12,2C6.47,2 2,6.5 2,12A10,10 0 0,0 12,22A10,10 0 0,0 22,12A10,10 0 0,0 12,2Z"
+            />
+          </svg>
+        </button>
+      </li>
+    </menu>
+    <script>
+      const { ipcRenderer } = require("electron");
+
+      const registerSendEvents = () => {
+        document.querySelectorAll("button").forEach((button) => {
+          button.addEventListener("click", (e) => {
+            ipcRenderer.send("button-click", { id: e.target.id });
+          });
+        });
+      };
+
+      const registerReceiveEvents = () => {
+        ipcRenderer.on("button-hidden", (e, button) => {
+          document.getElementById(button.id).parentNode.classList.toggle("hidden", button.hidden);
+        });
+        ipcRenderer.on("data-theme", (e, data) => {
+          document.documentElement.setAttribute("data-theme", data.theme);
+        });
+      };
+
+      registerSendEvents();
+      registerReceiveEvents();
+    </script>
+  </body>
+</html>
@@ -2,10 +2,38 @@ const fs = require("fs");
 const path = require("path");
 const crypto = require("crypto");
 const readline = require("readline/promises");
-const integration = require("./src/integration");
-const hardware = require("./src/hardware");
-const webview = require("./src/webview");
-const { app } = require("electron");
+const integration = require("./js/integration");
+const hardware = require("./js/hardware");
+const webview = require("./js/webview");
+const log = require("electron-log");
+const { app, powerMonitor } = require("electron");
+const Events = require("events");
+
+global.APP = global.APP || {};
+global.ARGS = global.ARGS || {};
+global.EVENTS = global.EVENTS || new Events();
+
+// Check display environment variable
+if (!process.env.DISPLAY) {
+  console.error(`\n$DISPLAY variable not set to run the GUI application, are you connected via SSH?\n`);
+  console.error(`If you have installed the service use:`);
+  console.error(`  systemctl --user start touchkio.service`);
+  console.error(`Alternatively export the variables first:`);
+  console.error(`  export DISPLAY=":0" && export WAYLAND_DISPLAY="wayland-0" && touchkio\n`);
+  process.exit(1);
+}
+
+// Move electron log file
+const elog = path.join(app.getPath("logs"), "electron.log");
+try {
+  if (fs.existsSync(elog)) {
+    fs.renameSync(elog, elog.replace(".log", ".old.log"));
+  }
+  console.debug = () => {};
+} catch (error) {
+  console.error("Failed to move electron log file:", error.message);
+}
+app.commandLine.appendSwitch("log-file", elog);

 /**
 * This promise resolves when the app has finished initializing,
@@ -13,40 +41,243 @@ const { app } = require("electron");
 * initialization tasks.
 */
 app.whenReady().then(async () => {
-  const lock = app.requestSingleInstanceLock();
-  if (!lock) {
-    console.error("TouchKio is already running");
-    return app.quit();
+  if (!(await initApp()) || !(await initArgs()) || !(await initLog())) {
+    return;
  }
+
+  // Show used arguments
+  const args = Object.assign({}, ARGS);
+  if ("mqtt_password" in args) {
+    args.mqtt_password = "*".repeat((args.mqtt_password || "").length);
+  }
+  console.info(`Arguments: ${JSON.stringify(args, null, 2)}`);
+  process.stdout.write("\n");
+
+  // Chained init functions
+  const chained = [
+    ["webview.js", webview.init],
+    ["hardware.js", hardware.init],
+    ["integration.js", integration.init],
+  ];
+  for (const [name, init] of chained) {
+    console.debug(`${name}: init()`);
+    if (!(await init())) {
+      console.debug(`${name}: init() --> aborted`);
+      break;
+    }
+  }
+});
+
+/**
+ * Initializes the global app object.
+ *
+ * @returns {bool} Returns true if the initialization was successful.
+ */
+const initApp = async () => {
+  const packageJsonPath = path.join(app.getAppPath(), "package.json");
+  const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
+
+  const buildJsonPath = path.join(app.getAppPath(), "build.json");
+  const buildFileExists = fs.existsSync(buildJsonPath);
+
+  // Set required app infos
+  APP.name = app.getName();
+  APP.title = packageJson.title;
+  APP.version = app.getVersion();
+  APP.path = app.getAppPath();
+  APP.icon = path.join(app.getAppPath(), "img", "icon.png");
+  APP.log = path.join(app.getPath("logs"), "main.log");
+  APP.cache = path.join(app.getPath("userData"), "Cache");
+  APP.config = app.getPath("userData");
+
+  // Set additional update infos
+  APP.homepage = `https://github.com/${packageJson.author}/${packageJson.name}`;
+  APP.releases = {
+    url: `https://api.github.com/repos/${packageJson.author}/${packageJson.name}/releases`,
+    latest: null,
+  };
+  APP.issues = `https://github.com/${packageJson.author}/${packageJson.name}/issues`;
+  APP.scripts = {
+    install: `https://raw.githubusercontent.com/${packageJson.author}/${packageJson.name}/main/install.sh`,
+  };
+
+  // Set additional build infos
+  APP.build = {};
+  if (buildFileExists) {
+    APP.build = JSON.parse(fs.readFileSync(buildJsonPath, "utf8"));
+  }
+
+  // Request single app instance lock
+  if (!app.requestSingleInstanceLock()) {
+    console.error(`${APP.title} is already running`);
+    return app.exit(1);
+  }
+
+  // Register app quit events
+  app.on("before-quit", () => {
+    APP.exiting = true;
+  });
+  app.on("will-quit", (e) => {
+    e.preventDefault();
+    process.exitCode = process.exitCode !== 0 ? 1 : 0;
+    const level = process.exitCode === 0 ? "warn" : "error";
+    console[level](`${APP.title} Terminated (${process.exitCode})`);
+    app.exit(process.exitCode);
+  });
+
+  // Register process exit events
+  ["SIGINT", "SIGTERM", "SIGQUIT", "exit"].forEach((signal) => {
+    process.on(signal, () => {
+      if (APP.exiting) {
+        return;
+      }
+      process.exitCode = 0;
+      APP.exiting = true;
+      app.quit();
+    });
+  });
+  powerMonitor.on("shutdown", () => {
+    if (APP.exiting) {
+      return;
+    }
+    process.exitCode = 0;
+    APP.exiting = true;
+    app.quit();
+  });
+
+  return true;
+};
+
+/**
+ * Initializes the global args object.
+ *
+ * @returns {bool} Returns true if the initialization was successful.
+ */
+const initArgs = async () => {
  let args = parseArgs(process);
  let argsProvided = !!Object.keys(args).length;

-  let argsFilePath = path.join(app.getPath("userData"), "Arguments.json");
+  let argsFilePath = path.join(APP.config, "Arguments.json");
  let argsFileExists = fs.existsSync(argsFilePath);

+  let argsFileHashPath = path.join(APP.cache, "Arguments.hash");
+  let argsFileHashExists = fs.existsSync(argsFileHashPath);
+
+  // Show version and release info
+  if ("help" in args || "version" in args) {
+    let build = "";
+    if (APP.build.id) {
+      build = ` (${APP.build.id}), built on ${APP.build.date} (${APP.build.platform}-${APP.build.arch}-${APP.build.maker})`;
+    }
+    console.info(`${APP.name}-v${APP.version}${build}\n${APP.homepage}`);
+    return app.exit(0);
+  }
+
  // Setup arguments from file path
-  if ("setup" in args || (!argsProvided && !argsFileExists)) {
+  if ((!argsProvided && !argsFileExists) || "setup" in args) {
    await sleep(3000);
    do {
      args = await promptArgs(process);
    } while (!Object.keys(args).length);
    writeArgs(argsFilePath, args);
-  } else if (!argsProvided && argsFileExists) {
-    args = readArgs(argsFilePath);
+  } else if (argsFileExists) {
+    args = { ...readArgs(argsFilePath), ...args };
  }

-  // Show used arguments
-  const json = JSON.stringify(args, null, 2);
-  console.log(`Arguments: ${json}`);
+  // Check arguments object
+  if (!Object.keys(args).length) {
+    console.error(`No arguments provided`);
+    return app.exit(1);
+  }

-  // Chained init functions
-  const chained = [webview.init, hardware.init, integration.init];
-  for (const init of chained) {
-    if (!(await init(args))) {
-      break;
+  // Split url arguments
+  args.web_url = args.web_url || [];
+  if (!Array.isArray(args.web_url)) {
+    args.web_url = args.web_url.split(",").map((url) => url.trim());
  }
+
+  // Calculate arguments hash
+  const argsFileHash = crypto.createHash("sha256").update(JSON.stringify(args)).digest("hex");
+  const argsUpdated = argsFileHashExists && argsFileHash !== fs.readFileSync(argsFileHashPath, "utf8");
+  if (argsUpdated && !("app_reset" in args)) {
+    args.app_reset = "arguments";
  }
-});
+  if (fs.existsSync(APP.cache)) {
+    fs.writeFileSync(argsFileHashPath, argsFileHash);
+  }
+
+  // Set global arguments
+  ARGS = args;
+
+  return true;
+};
+
+/**
+ * Initializes the global log object.
+ *
+ * @returns {bool} Returns true if the initialization was successful.
+ */
+const initLog = async () => {
+  try {
+    if (fs.existsSync(APP.log)) {
+      fs.renameSync(APP.log, APP.log.replace(".log", ".old.log"));
+    }
+  } catch (error) {
+    console.error("Failed to move main log file:", error.message);
+  }
+
+  // Set log level and path
+  const level = "enable_logging" in ARGS ? "silly" : "app_debug" in ARGS ? "debug" : "verbose";
+  log.transports.file.level = level;
+  log.transports.console.level = level;
+  log.transports.file.resolvePathFn = () => {
+    return APP.log;
+  };
+
+  // Catch unhandled errors
+  log.errorHandler.startCatching({
+    showDialog: false,
+    onError({ error, versions }) {
+      if (!error?.message?.includes("Object has been destroyed")) {
+        const build = { ...APP.build, ...versions };
+        const whoopsie = "💥 Whoopsie!";
+        const section2 = `# Description\n- Hardware information?\n- How to reproduce?\n- Additional logs?\n`;
+        const section3 = `# Error\n\`\`\`bash\n${new Date().toISOString()}: ${error.stack}\n\`\`\`\n`;
+        const section4 = `# Application\n\`\`\`json\n${JSON.stringify(build, null, 2)}\n\`\`\`\n`;
+        const title = encodeURIComponent(`${whoopsie} - ${error}`);
+        const body = encodeURIComponent(`${section2}\n${section3}\n${section4}`);
+        console.error(`${whoopsie} -`, error, build);
+        console.info(`🪲 Report issue --> ${APP.issues}/new?title=${title}&body=${body}`);
+      }
+      app.quit();
+    },
+  });
+
+  // Emit console log
+  APP.logs = [];
+  log.hooks.push((message, transport, type) => {
+    const data = message.data.map((d) => (typeof d === "object" ? String(d?.message) || JSON.stringify(d) : String(d)));
+    const text = data.filter((s) => s && s.trim()).join(" ");
+    if (!text.startsWith("(node:") && type === "console") {
+      APP.logs.unshift({
+        time: message.date,
+        level: message.level,
+        text: text,
+      });
+      if (APP.logs.length > 10) {
+        APP.logs.splice(10);
+      }
+      EVENTS.emit("consoleLog", APP.logs[0]);
+    }
+    return message;
+  });
+
+  // Overwrite console log
+  Object.assign(console, log.functions);
+  console.silly("Welcome To The Jungle!");
+
+  return true;
+};

 /**
 * Parses command-line arguments from the given process object.
@@ -55,14 +286,13 @@ app.whenReady().then(async () => {
 * @returns {Object} An object mapping argument names to their corresponding values.
 */
 const parseArgs = (proc) => {
-  let args = {};
-  proc.argv.slice(1).forEach((arg) => {
-    if (arg !== ".") {
-      const [key, value] = arg.split("=");
-      args[key.replace("--", "").replace("-", "_")] = value;
-    }
-  });
-  return args;
+  const args = proc.argv.slice(1).filter((arg) => arg !== ".");
+  return Object.fromEntries(
+    args.flatMap((arg) => {
+      const match = arg.match(/^--?([^=]+)(?:=(.*))?$/);
+      return match ? [[match[1].replace(/-/g, "_"), match[2] ?? null]] : [];
+    }),
+  );
 };

 /**
@@ -94,6 +324,11 @@ const promptArgs = async (proc) => {
      question: "Enter WEB zoom level",
      fallback: "1.25",
    },
+    {
+      key: "web_widget",
+      question: "Enter WEB widget enabled",
+      fallback: "true",
+    },
    {
      key: "mqtt",
      question: "\nConnect to MQTT Broker?",
@@ -129,6 +364,7 @@ const promptArgs = async (proc) => {
  // Prompt questions and wait for the answers
  let args = {};
  let ignore = [];
+  try {
    for (const { key, question, fallback } of prompts) {
      if (key === "mqtt") {
        const prompt = `${question} (${fallback}): `;
@@ -149,10 +385,20 @@ const promptArgs = async (proc) => {
        const prompt = `${question} (${fallback}): `;
        const answer = await read.question(prompt);
        const value = answer.trim() || fallback;
+        if (key === "web_url") {
+          args[key] = value.split(",").map((v) => v.trim());
+        } else {
          args[key] = value;
        }
      }
+    }
+  } catch (error) {
+    console.error(`\n${error.message}`);
+    args = {};
+    app.exit(1);
+  } finally {
    read.close();
+  }

  return args;
 };
@@ -164,11 +410,15 @@ const promptArgs = async (proc) => {
 * @param {Object} args - The arguments object.
 */
 const writeArgs = (path, args) => {
+  try {
    const argc = Object.assign({}, args);
    if ("mqtt_password" in argc) {
      argc.mqtt_password = encrypt(argc.mqtt_password);
    }
    fs.writeFileSync(path, JSON.stringify(argc, null, 2));
+  } catch (error) {
+    console.error(`Failed to write ${path}:`, error.message);
+  }
 };

 /**
@@ -178,11 +428,16 @@ const writeArgs = (path, args) => {
 * @returns {Object} The arguments object.
 */
 const readArgs = (path) => {
-  const args = JSON.parse(fs.readFileSync(path));
+  try {
+    const args = JSON.parse(fs.readFileSync(path, "utf8"));
    if ("mqtt_password" in args) {
      args.mqtt_password = decrypt(args.mqtt_password);
    }
    return args;
+  } catch (error) {
+    console.error(`Failed to parse ${path}:`, error.message);
+  }
+  return {};
 };

 /**
@@ -193,7 +448,7 @@ const readArgs = (path) => {
 */
 const encrypt = (value) => {
  const iv = crypto.randomBytes(16);
-  const key = crypto.scryptSync(hardware.getMachineId(), app.getName(), 32);
+  const key = crypto.scryptSync(hardware.getMachineId(), APP.name, 32);
  const cipher = crypto.createCipheriv("aes-256-cbc", key, iv);
  let encrypted = cipher.update(value, "utf8", "hex");
  encrypted += cipher.final("hex");
@@ -209,7 +464,7 @@ const encrypt = (value) => {
 const decrypt = (value) => {
  const p = Buffer.from(value, "base64").toString("utf8").split(":");
  const iv = Buffer.from(p.shift(), "hex");
-  const key = crypto.scryptSync(hardware.getMachineId(), app.getName(), 32);
+  const key = crypto.scryptSync(hardware.getMachineId(), APP.name, 32);
  const decipher = crypto.createDecipheriv("aes-256-cbc", key, iv);
  const buffer = Buffer.from(p.join(":"), "hex");
  let decrypted = decipher.update(buffer, "binary", "utf8");
@@ -223,4 +478,6 @@ const decrypt = (value) => {
 * @param {number} ms - Sleep time in milliseconds.
 * @returns {Promise} A promise resolving after the timeout.
 */
-const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+const sleep = (ms) => {
+  return new Promise((r) => setTimeout(r, ms));
+};
@@ -1,41 +1,64 @@
 #!/usr/bin/env bash

+# Read arguments
+ARG_EARLY=false
+ARG_UPDATE=false
+for arg in "$@"; do
+  case "$arg" in
+    early) ARG_EARLY=true ;;
+    update) ARG_UPDATE=true ;;
+  esac
+done
+
+# Determine system architecture
+echo -e "Determining system architecture..."
+
+BITS=$(getconf LONG_BIT)
+case "$(uname -m)" in
+    x86_64) ARCH="x64" ;;
+    aarch64) ARCH="arm64" ;;
+    *) { echo "Architecture $(uname -m) running $BITS-bit operating system is not supported."; exit 1; } ;;
+esac
+
+[ "$BITS" -eq 64 ] || { echo "Architecture $ARCH running $BITS-bit operating system is not supported."; exit 1; }
+echo "Architecture $ARCH running $BITS-bit operating system is supported."
+
 # Download the latest .deb package
-echo -e "Downloading the latest release..."
+echo -e "\nDownloading the latest release..."

-DEB_URL=$(wget -qO- https://api.github.com/repos/leukipp/touchkio/releases/latest | \
-grep -o '"browser_download_url": "[^"]*\.deb"' | \
-sed 's/"browser_download_url": "//;s/"//g')
-DEB_PATH="/tmp/$(basename "$DEB_URL")"
+TMP_DIR=$(mktemp -d)
+chmod 755 "$TMP_DIR"

-if [ -z "$DEB_URL" ]; then
-    echo "Download url for .deb file not found."
-    exit 1
+JSON=$(wget -qO- "https://api.github.com/repos/leukipp/touchkio/releases" | tr -d '\r\n')
+if $ARG_EARLY; then
+  DEB_REG='"prerelease":\s*(true|false).*?"browser_download_url":\s*"\K[^\"]*_'$ARCH'\.deb'
+else
+  DEB_REG='"prerelease":\s*false.*?"browser_download_url":\s*"\K[^\"]*_'$ARCH'\.deb'
 fi

-if ! wget --show-progress -q -O "$DEB_PATH" "$DEB_URL"; then
-    echo "Failed to download the .deb file."
-    exit 1
-fi
+DEB_URL=$(echo "$JSON" | grep -oP "$DEB_REG" | head -n 1)
+DEB_PATH="${TMP_DIR}/$(basename "$DEB_URL")"
+
+[ -z "$DEB_URL" ] && { echo "Download url for .deb file not found."; exit 1; }
+wget --show-progress -q -O "$DEB_PATH" "$DEB_URL" || { echo "Failed to download the .deb file."; exit 1; }

 # Install the latest .deb package
 echo -e "\nInstalling the latest release..."

-if ! sudo dpkg -i "$DEB_PATH"; then
-    echo "Installation of .deb file failed."
-    exit 1
-fi
+command -v apt &> /dev/null || { echo "Package manager apt was not found."; exit 1; }
+sudo apt install -y "$DEB_PATH" || { echo "Installation of .deb file failed."; exit 1; }

 # Create the systemd user service
 echo -e "\nCreating systemd user service..."

-SERVICE_FILE="$HOME/.config/systemd/user/touchkio.service"
-mkdir -p "$(dirname "$SERVICE_FILE")" || { echo "Failed to create directory for $SERVICE_FILE"; exit 1; }
+SERVICE_NAME="touchkio.service"
+SERVICE_FILE="$HOME/.config/systemd/user/$SERVICE_NAME"
+mkdir -p "$(dirname "$SERVICE_FILE")" || { echo "Failed to create directory for $SERVICE_FILE."; exit 1; }

-bash -c "cat << EOF > \"$SERVICE_FILE\"
-[Unit]
+SERVICE_CONTENT="[Unit]
 Description=TouchKio
 After=graphical.target
+Wants=network-online.target

 [Service]
 ExecStart=/usr/bin/touchkio
@@ -43,41 +66,58 @@ Restart=on-failure
 RestartSec=5s

 [Install]
-WantedBy=default.target
-EOF"
+WantedBy=default.target"

-systemctl --user enable "$(basename "$SERVICE_FILE")" || { echo "Failed to enable service $SERVICE_FILE"; exit 1; }
-echo "Service $SERVICE_FILE enabled"
+if $ARG_UPDATE; then
+  if systemctl --user --quiet is-active "${SERVICE_NAME}"; then
+    systemctl --user restart "${SERVICE_NAME}"
+    echo "Existing $SERVICE_NAME restarted."
+  else
+    echo "Existing $SERVICE_NAME not running, start touchkio manually."
+  fi
+  exit 0
+fi

-# Create the udev rule for backlight
-echo -e "\nCreating udev rule for backlight..."
+SERVICE_CREATE=true
+if [ -f "$SERVICE_FILE" ]; then
+    read -p "Service $SERVICE_FILE exists, overwrite? (y/N) " overwrite
+    [[ ${overwrite:-n} == [Yy]* ]] || SERVICE_CREATE=false
+fi

-UDEV_FILE="/etc/udev/rules.d/backlight-permissions.rules"
-sudo bash -c "cat << EOF > \"$UDEV_FILE\"
-SUBSYSTEM==\"backlight\", KERNEL==\"10-0045\", RUN+=\"/bin/chmod 666 /sys/class/backlight/%k/bl_power /sys/class/backlight/%k/brightness\"
-EOF"
-echo "Rule $UDEV_FILE created"
+if $SERVICE_CREATE; then
+    echo "$SERVICE_CONTENT" > "$SERVICE_FILE" || { echo "Failed to write to $SERVICE_FILE."; exit 1; }
+    systemctl --user enable "$(basename "$SERVICE_FILE")" || { echo "Failed to enable service $SERVICE_FILE."; exit 1; }
+    echo "Service $SERVICE_FILE enabled."
+else
+    echo "Service $SERVICE_FILE not created."
+fi

 # Export display variables
 echo -e "\nExporting display variables..."

 if [ -z "$DISPLAY" ]; then
    export DISPLAY=":0"
-    echo "DISPLAY was not set, defaulting to \"$DISPLAY\""
+    echo "DISPLAY was not set, defaulting to \"$DISPLAY\"."
 else
-    echo "DISPLAY is set to \"$DISPLAY\""
+    echo "DISPLAY is set to \"$DISPLAY\"."
 fi
+
 if [ -z "$WAYLAND_DISPLAY" ]; then
    export WAYLAND_DISPLAY="wayland-0"
-    echo "WAYLAND_DISPLAY was not set, defaulting to \"$WAYLAND_DISPLAY\""
+    echo "WAYLAND_DISPLAY was not set, defaulting to \"$WAYLAND_DISPLAY\"."
 else
-    echo "WAYLAND_DISPLAY is set to \"$WAYLAND_DISPLAY\""
+    echo "WAYLAND_DISPLAY is set to \"$WAYLAND_DISPLAY\"."
 fi

 # Start the setup mode
-echo ""
-read -p "Start touchkio setup? (Y/n) " answer
-if [[ ${answer:-y} == [Yy]* ]]; then
+read -p $'\nStart touchkio setup? (Y/n) ' setup
+
+if [[ ${setup:-y} == [Yy]* ]]; then
    echo "/usr/bin/touchkio --setup"
    /usr/bin/touchkio --setup
+else
+    echo "/usr/bin/touchkio"
+    /usr/bin/touchkio
 fi
+
+exit 0
@@ -1,66 +1,31 @@
 {
    "name": "touchkio",
+    "title": "TouchKio",
    "description": "Home Assistant Touch Kiosk",
+    "homepage": "https://github.com/leukipp/touchkio",
    "author": "leukipp",
-    "version": "1.0.1",
+    "version": "1.4.2",
    "license": "MIT",
    "main": "index.js",
    "scripts": {
-        "start": "electron . --web-url=https://demo.home-assistant.io",
+        "start": "electron . --web-url=https://demo.home-assistant.io,https://demo.immichkiosk.app --trace-warnings",
        "build": "electron-forge make"
    },
-    "config": {
-        "forge": {
-            "packagerConfig": {
-                "ignore": [
-                    ".gitignore",
-                    ".github/",
-                    "docs/"
-                ]
-            },
-            "makers": [
-                {
-                    "name": "@electron-forge/maker-zip"
-                },
-                {
-                    "name": "@electron-forge/maker-deb",
-                    "config": {
-                        "options": {
-                            "productName": "TouchKio",
-                            "icon": "img/icon.png",
-                            "categories": [
-                                "Network"
-                            ]
-                        }
-                    }
-                }
-            ],
-            "publishers": [
-                {
-                    "name": "@electron-forge/publisher-github",
-                    "config": {
-                        "repository": {
-                            "owner": "leukipp",
-                            "name": "touchkio"
-                        },
-                        "draft": true
-                    }
-                }
-            ]
-        }
-    },
    "prettier": {
        "printWidth": 120
    },
    "devDependencies": {
-        "@electron-forge/cli": "^7.6.0",
-        "@electron-forge/maker-deb": "^7.6.0",
-        "@electron-forge/maker-zip": "^7.6.0",
-        "@electron-forge/publisher-github": "^7.6.0",
-        "electron": "^33.3.1",
-        "prettier": "^3.4.2"
+        "@electron-forge/cli": "^7.10.2",
+        "@electron-forge/maker-deb": "^7.10.2",
+        "@electron-forge/maker-zip": "^7.10.2",
+        "@electron-forge/publisher-github": "^7.10.2",
+        "electron": "^39.2.4",
+        "jszip": "^3.10.1",
+        "prettier": "^3.6.2"
    },
    "dependencies": {
-        "mqtt": "^5.10.3"
+        "axios": "^1.13.2",
+        "electron-log": "^5.4.3",
+        "mqtt": "^5.14.1"
    }
 }
@@ -1,461 +0,0 @@
-const os = require("os");
-const fs = require("fs");
-const path = require("path");
-const process = require("child_process");
-
-global.HARDWARE = global.HARDWARE || {
-  initialized: false,
-  status: "invalid",
-  display: {
-    name: null,
-    status: {
-      path: null,
-      value: null,
-    },
-    brightness: {
-      path: null,
-      value: null,
-      max: null,
-    },
-    notifiers: [],
-  },
-};
-
-/**
- * Initializes the hardware with the provided arguments.
- *
- * @param {Object} args - The command-line arguments to customize the initialization process.
- * @returns {boolean} Returns true if the initialization was successful.
- */
-const init = async (args) => {
-  if (!args.mqtt_url) {
-    return false;
-  }
-
-  // Check device support
-  if (!compatibleDevice()) {
-    console.warn("Device not supported");
-    return false;
-  }
-
-  // Check model support
-  const model = getModel();
-  if (!model || !model.includes("Raspberry Pi")) {
-    console.warn(`${model} not supported`);
-    return false;
-  }
-
-  // Init globals
-  HARDWARE.display.name = getDisplayName();
-  HARDWARE.display.status.path = getDisplayStatusPath(HARDWARE.display.name);
-  HARDWARE.display.brightness.path = getDisplayBrightnessPath(HARDWARE.display.name);
-  HARDWARE.display.brightness.max = getDisplayBrightnessMax();
-  HARDWARE.initialized = true;
-  HARDWARE.status = "valid";
-
-  // Show device infos
-  console.log("\nModel:", model);
-  console.log("Serial Number:", getSerialNumber());
-  console.log("Host Name:", getHostName());
-  console.log("Up Time:", getUpTime());
-  console.log("Memory Size:", getMemorySize());
-  console.log("Memory Usage:", getMemoryUsage());
-  console.log("Processor Usage:", getProcessorUsage());
-  console.log("Processor Temperature:", getProcessorTemperature());
-
-  // Show display infos
-  console.log("\nDisplay Name:", HARDWARE.display.name);
-  console.log(`Display Status [${HARDWARE.display.status.path}]:`, getDisplayStatus());
-  console.log(`Display Brightness [${HARDWARE.display.brightness.path}]:`, getDisplayBrightness(), "\n");
-
-  // Check for display changes
-  setInterval(update, 500);
-
-  return true;
-};
-
-/**
- * Updates the shared hardware properties.
- */
-const update = () => {
-  if (!HARDWARE.initialized) {
-    return;
-  }
-
-  // Display status has changed
-  if (HARDWARE.display.status.path !== null) {
-    const status = fs.readFileSync(`${HARDWARE.display.status.path}/enabled`, "utf8").trim();
-    if (status !== HARDWARE.display.status.value) {
-      console.log("Update Display Status:", getDisplayStatus());
-      HARDWARE.display.status.value = status;
-      HARDWARE.display.notifiers.forEach((notifier) => {
-        notifier();
-      });
-    }
-  }
-
-  // Display brightness has changed
-  if (HARDWARE.display.brightness.path !== null) {
-    const brightness = fs.readFileSync(`${HARDWARE.display.brightness.path}/brightness`, "utf8").trim();
-    if (brightness !== HARDWARE.display.brightness.value) {
-      console.log("Update Display Brightness:", getDisplayBrightness());
-      HARDWARE.display.brightness.value = brightness;
-      HARDWARE.display.notifiers.forEach((notifier) => {
-        notifier();
-      });
-    }
-  }
-};
-
-/**
- * Verifies device compatibility by checking the presence of necessary sys files.
- *
- * @returns {bool} Returns true if all files exists.
- */
-const compatibleDevice = () => {
-  const files = [
-    "/sys/class/drm",
-    "/sys/class/backlight",
-    "/sys/firmware/devicetree/base/model",
-    "/sys/firmware/devicetree/base/serial-number",
-  ];
-  return files.every((file) => fs.existsSync(file));
-};
-
-/**
- * Gets the Raspberry Pi model name using `/sys/firmware/devicetree/base/model`.
- *
- * @returns {string|null} The model of the Raspberry Pi or null if an error occurs.
- */
-const getModel = () => {
-  return execSyncCommand("cat", ["/sys/firmware/devicetree/base/model"]);
-};
-
-/**
- * Gets the Raspberry Pi serial number using `/sys/firmware/devicetree/base/serial-number`.
- *
- * @returns {string|null} The serial number of the Raspberry Pi or null if an error occurs.
- */
-const getSerialNumber = () => {
-  return execSyncCommand("cat", ["/sys/firmware/devicetree/base/serial-number"]);
-};
-
-/**
- * Gets the host machine id using `/etc/machine-id`.
- *
- * @returns {string|null} The machine id of the system.
- */
-const getMachineId = () => {
-  return execSyncCommand("cat", ["/etc/machine-id"]);
-};
-
-/**
- * Gets the host name of the current system using `os.hostname()`.
- *
- * @returns {string} The host name of the system.
- */
-const getHostName = () => {
-  return os.hostname();
-};
-
-/**
- * Gets the up time of the system in minutes using `os.uptime()`.
- *
- * @returns {number} The up time of the system in minutes.
- */
-const getUpTime = () => {
-  return os.uptime() / 60;
-};
-
-/**
- * Gets the total available memory in gibibytes using `os.totalmem()`.
- *
- * @returns {number} The total available memory in GiB.
- */
-const getMemorySize = () => {
-  return os.totalmem() / 1024 ** 3;
-};
-
-/**
- * Gets the current memory usage as a percentage using `os.totalmem()` and `os.freemem()`.
- *
- * @returns {number} The percentage of used memory.
- */
-const getMemoryUsage = () => {
-  return ((os.totalmem() - os.freemem()) / os.totalmem()) * 100;
-};
-
-/**
- * Gets the CPU load average over the last 5 minutes as a percentage using `os.loadavg()` and `os.cpus()`.
- *
- * @returns {number} The CPU load average percentage over the last 5 minutes.
- */
-const getProcessorUsage = () => {
-  return (os.loadavg()[1] / os.cpus().length) * 100;
-};
-
-/**
- * Gets the current CPU temperature using `vcgencmd measure_temp`.
- *
- * @returns {number|null} The CPU temperature in degrees Celsius or null if an error occurs.
- */
-const getProcessorTemperature = () => {
-  const output = execSyncCommand("vcgencmd", ["measure_temp"]);
-  if (output !== null) {
-    const temp = output.match(/temp=(\d+\.\d+)/);
-    if (temp && temp[1]) {
-      return parseFloat(temp[1]);
-    }
-  }
-  return null;
-};
-
-/**
- * Gets the primary display name using `wlopm`.
- *
- * @returns {string|null} The output of the command or null if an error occurs.
- */
-const getDisplayName = () => {
-  const status = execSyncCommand("wlopm", []);
-  if (status !== null) {
-    const out = status.split("\n")[0].split(" ");
-    return out.shift();
-  }
-  return null;
-};
-
-/**
- * Gets the current display status path using `/sys/class/drm`.
- *
- * @param {string} name - Primary display name.
- * @returns {string|null} The display status path or null if nothing was found.
- */
-const getDisplayStatusPath = (name) => {
-  const drm = "/sys/class/drm";
-  for (const card of fs.readdirSync(drm)) {
-    const statusFile = path.join(drm, card, "status");
-    if (!fs.existsSync(statusFile)) {
-      continue;
-    }
-    const content = fs.readFileSync(statusFile, "utf8").trim();
-    if (card.includes(name) && content === "connected") {
-      return path.join(drm, card);
-    }
-  }
-  return null;
-};
-
-/**
- * Gets the current display power status using `wlopm`.
- *
- * @returns {string|null} The output of the command or null if an error occurs.
- */
-const getDisplayStatus = () => {
-  const status = execSyncCommand("wlopm", []);
-  if (status !== null) {
-    const out = status.split("\n")[0].split(" ");
-    return out.pop().toUpperCase();
-  }
-  return null;
-};
-
-/**
- * Sets the display power status using `wlopm`.
- *
- * This function takes a desired status ('ON' or 'OFF') and executes
- * the appropriate command to set the display status.
- *
- * @param {string} status - The desired status ('ON' or 'OFF').
- * @param {function} callback - A callback function that receives the output or error.
- */
-const setDisplayStatus = (status, callback = null) => {
-  if (status !== "ON" && status !== "OFF") {
-    console.error("Status must be 'ON' or 'OFF'");
-    if (typeof callback === "function") callback(null, "Invalid status");
-    return;
-  }
-  const args = [`--${status.toLowerCase()}`, HARDWARE.display.name];
-  execAsyncCommand("wlopm", args, callback);
-};
-
-/**
- * Gets the current display brightness path using `/sys/class/backlight`.
- *
- * @param {string} name - Primary display name.
- * @returns {string|null} The display brightness path or null if nothing was found.
- */
-const getDisplayBrightnessPath = (name) => {
-  const backlight = "/sys/class/backlight";
-  for (const address of fs.readdirSync(backlight)) {
-    const nameFile = path.join(backlight, address, "display_name");
-    if (!fs.existsSync(nameFile)) {
-      continue;
-    }
-    const content = fs.readFileSync(nameFile, "utf8").trim();
-    if (content.includes(name)) {
-      return path.join(backlight, address);
-    }
-  }
-  return null;
-};
-
-/**
- * Gets the maximum display brightness value using `/sys/class/backlight/.../max_brightness`.
- *
- * @returns {number|null} The brightness maximum value or null if an error occurs.
- */
-const getDisplayBrightnessMax = () => {
-  if (!HARDWARE.display.brightness.path) {
-    return null;
-  }
-  const max = execSyncCommand("cat", [`${HARDWARE.display.brightness.path}/max_brightness`]);
-  if (max !== null) {
-    return parseInt(max, 10);
-  }
-  return null;
-};
-
-/**
- * Gets the current display brightness level using `/sys/class/backlight/.../brightness`.
- *
- * @returns {number|null} The brightness level as a percentage or null if an error occurs.
- */
-const getDisplayBrightness = () => {
-  if (!HARDWARE.display.brightness.path) {
-    return null;
-  }
-  const brightness = execSyncCommand("cat", [`${HARDWARE.display.brightness.path}/brightness`]);
-  if (brightness !== null) {
-    const max = HARDWARE.display.brightness.max;
-    return Math.round((parseInt(brightness, 10) / max) * 100);
-  }
-  return null;
-};
-
-/**
- * Sets the display brightness level using `/sys/class/backlight/.../brightness`.
- *
- * This function takes a brightness value between 1 to 100 percent,
- * maps it to the proper range and writes it to the system.
- *
- * @param {number} brightness - The desired brightness level (1-100).
- * @param {function} callback - A callback function that receives the output or error.
- */
-const setDisplayBrightness = (brightness, callback = null) => {
-  if (!HARDWARE.display.brightness.path) {
-    return;
-  }
-  if (typeof brightness !== "number" || brightness < 1 || brightness > 100) {
-    console.error("Brightness must be a number between 1 and 100");
-    if (typeof callback === "function") callback(null, "Invalid brightness");
-    return;
-  }
-  const max = HARDWARE.display.brightness.max;
-  const value = Math.max(1, Math.min(Math.round((brightness / 100) * max), max));
-  const proc = execAsyncCommand("tee", [`${HARDWARE.display.brightness.path}/brightness`], callback);
-  proc.stdin.write(value.toString());
-  proc.stdin.end();
-};
-
-/**
- * Shuts down the system using `sudo shutdown -h now`.
- *
- * This function executes the command asynchronously.
- * The output of the command will be provided through the callback function.
- *
- * @param {function} callback - A callback function that receives the output or error.
- */
-const shutdownSystem = (callback = null) => {
-  execAsyncCommand("sudo", ["shutdown", "-h", "now"], callback);
-};
-
-/**
- * Reboots the system using `sudo reboot`.
- *
- * This function executes the command asynchronously.
- * The output of the command will be provided through the callback function.
- *
- * @param {function} callback - A callback function that receives the output or error.
- */
-const rebootSystem = (callback = null) => {
-  execAsyncCommand("sudo", ["reboot"], callback);
-};
-
-/**
- * Executes a command synchronously and returns the output.
- *
- * @param {string} cmd - The command to execute.
- * @param {Array<string>} args - The arguments for the command.
- * @returns {string|null} The output of the command or null if an error occurs.
- */
-const execSyncCommand = (cmd, args = []) => {
-  try {
-    const output = process.execSync([cmd, ...args].join(" "), { encoding: "utf8" });
-    return output.trim().replace(/\0/g, "");
-  } catch (error) {
-    console.error("Execute Sync:", error.message);
-  }
-  return null;
-};
-
-/**
- * Executes a command asynchronously.
- *
- * @param {string} cmd - The command to execute.
- * @param {Array<string>} args - The arguments for the command.
- * @param {function} callback - A callback function that receives the output or error.
- * @returns {object} The spawned process object.
- */
-const execAsyncCommand = (cmd, args = [], callback = null) => {
-  let errorOutput = "";
-  let successOutput = "";
-  let proc = process.spawn(cmd, args);
-  proc.stderr.on("data", (data) => {
-    if (data) {
-      errorOutput += data.toString();
-    }
-  });
-  proc.stdout.on("data", (data) => {
-    if (data) {
-      successOutput += data.toString();
-    }
-  });
-  proc.on("close", (code) => {
-    try {
-      if (typeof callback === "function") {
-        if (code === 0) {
-          callback(successOutput.trim().replace(/\0/g, ""), null);
-        } else {
-          callback(null, errorOutput.trim().replace(/\0/g, ""));
-        }
-      }
-    } catch (error) {
-      console.error("Execute Async:", error.message);
-    }
-  });
-  return proc;
-};
-
-module.exports = {
-  init,
-  update,
-  getModel,
-  getSerialNumber,
-  getMachineId,
-  getHostName,
-  getUpTime,
-  getMemorySize,
-  getMemoryUsage,
-  getProcessorUsage,
-  getProcessorTemperature,
-  getDisplayName,
-  getDisplayStatusPath,
-  getDisplayStatus,
-  setDisplayStatus,
-  getDisplayBrightnessPath,
-  getDisplayBrightnessMax,
-  getDisplayBrightness,
-  setDisplayBrightness,
-  shutdownSystem,
-  rebootSystem,
-};
@@ -1,617 +0,0 @@
-const mqtt = require("mqtt");
-const hardware = require("./hardware");
-const { app } = require("electron");
-
-global.INTEGRATION = global.INTEGRATION || {
-  initialized: false,
-  status: "offline",
-};
-
-/**
- * Initializes the integration with the provided arguments.
- *
- * @param {Object} args - The command-line arguments to customize the initialization process.
- * @returns {boolean} Returns true if the initialization was successful.
- */
-const init = async (args) => {
-  if (!args.mqtt_url) {
-    return false;
-  }
-  const url = new URL(args.mqtt_url);
-  const user = args.mqtt_user ? args.mqtt_user : null;
-  const password = args.mqtt_password ? args.mqtt_password : null;
-  const discovery = args.mqtt_discovery ? args.mqtt_discovery : "homeassistant";
-
-  const model = hardware.getModel();
-  const hostName = hardware.getHostName();
-  const serialNumber = hardware.getSerialNumber();
-
-  const deviceId = serialNumber.slice(-6).toUpperCase();
-  const deviceName = hostName.charAt(0).toUpperCase() + hostName.slice(1);
-
-  // Init globals
-  INTEGRATION.node = `rpi_${deviceId}`;
-  INTEGRATION.discovery = discovery;
-  INTEGRATION.device = {
-    name: `Raspberry Pi ${deviceName}`,
-    model: model,
-    serial_number: serialNumber,
-    manufacturer: "Raspberry Pi Ltd",
-    identifiers: [INTEGRATION.node],
-    sw_version: `${app.getName()}-v${app.getVersion()}`,
-  };
-
-  // Connection settings
-  const masked = password === null ? "null" : "*".repeat(password.length);
-  const options =
-    user === null || password == null
-      ? null
-      : {
-          username: user,
-          password: password,
-        };
-  console.log("MQTT Connecting:", `${user}:${masked}@${url.toString()}`);
-  INTEGRATION.client = mqtt.connect(url.toString(), options);
-
-  // Client connected
-  INTEGRATION.client
-    .on("connect", () => {
-      console.log(`MQTT Connected: ${url.toString()}\n`);
-
-      // Init client controls
-      initShutdown(INTEGRATION.client);
-      initReboot(INTEGRATION.client);
-      initRefresh(INTEGRATION.client);
-      initKiosk(INTEGRATION.client);
-      initDisplay(INTEGRATION.client);
-
-      // Init client sensors
-      initModel(INTEGRATION.client);
-      initSerialNumber(INTEGRATION.client);
-      initHostName(INTEGRATION.client);
-      initUpTime(INTEGRATION.client);
-      initMemorySize(INTEGRATION.client);
-      initMemoryUsage(INTEGRATION.client);
-      initProcessorUsage(INTEGRATION.client);
-      initProcessorTemperature(INTEGRATION.client);
-      initHeartbeat(INTEGRATION.client);
-
-      // Integration initialized
-      INTEGRATION.initialized = true;
-      INTEGRATION.status = "online";
-    })
-    .on("error", (error) => {
-      console.error("MQTT:", error);
-      INTEGRATION.status = "offline";
-    });
-
-  // Update sensor states on display change
-  HARDWARE.display.notifiers.push(() => {
-    updateDisplay(INTEGRATION.client);
-  });
-
-  // Update heartbeat time periodically (30s)
-  setInterval(() => {
-    updateHeartbeat(INTEGRATION.client);
-  }, 30 * 1000);
-
-  // Update sensor states periodically (1min)
-  setInterval(update, 60 * 1000);
-
-  return true;
-};
-
-/**
- * Updates the shared integration properties.
- */
-const update = () => {
-  if (!INTEGRATION.initialized) {
-    return;
-  }
-
-  // Update client sensors
-  updateKiosk(INTEGRATION.client);
-  updateUpTime(INTEGRATION.client);
-  updateMemoryUsage(INTEGRATION.client);
-  updateProcessorUsage(INTEGRATION.client);
-  updateProcessorTemperature(INTEGRATION.client);
-};
-
-/**
- * Initializes the shutdown button and handles the execute logic.
- *
- * @param {Object} client - Instance of the mqtt client.
- */
-const initShutdown = (client) => {
-  const root = `${INTEGRATION.discovery}/button/${INTEGRATION.node}/shutdown`;
-  const config = {
-    name: "Shutdown",
-    unique_id: `${INTEGRATION.node}_shutdown`,
-    command_topic: `${root}/execute`,
-    icon: "mdi:power",
-    device: INTEGRATION.device,
-  };
-  client
-    .publish(`${root}/config`, JSON.stringify(config), { qos: 1, retain: true })
-    .on("message", (topic, message) => {
-      if (topic === `${root}/execute`) {
-        console.log("Shutdown system...");
-        hardware.setDisplayStatus("ON");
-        hardware.shutdownSystem();
-      }
-    })
-    .subscribe(`${root}/execute`);
-};
-
-/**
- * Initializes the reboot button and handles the execute logic.
- *
- * @param {Object} client - Instance of the mqtt client.
- */
-const initReboot = (client) => {
-  const root = `${INTEGRATION.discovery}/button/${INTEGRATION.node}/reboot`;
-  const config = {
-    name: "Reboot",
-    unique_id: `${INTEGRATION.node}_reboot`,
-    command_topic: `${root}/execute`,
-    icon: "mdi:restart",
-    device: INTEGRATION.device,
-  };
-  client
-    .publish(`${root}/config`, JSON.stringify(config), { qos: 1, retain: true })
-    .on("message", (topic, message) => {
-      if (topic === `${root}/execute`) {
-        console.log("Rebooting system...");
-        hardware.setDisplayStatus("ON");
-        hardware.rebootSystem();
-      }
-    })
-    .subscribe(`${root}/execute`);
-};
-
-/**
- * Initializes the refresh button and handles the execute logic.
- *
- * @param {Object} client - Instance of the mqtt client.
- */
-const initRefresh = (client) => {
-  const root = `${INTEGRATION.discovery}/button/${INTEGRATION.node}/refresh`;
-  const config = {
-    name: "Refresh",
-    unique_id: `${INTEGRATION.node}_refresh`,
-    command_topic: `${root}/execute`,
-    icon: "mdi:web-refresh",
-    device: INTEGRATION.device,
-  };
-  client
-    .publish(`${root}/config`, JSON.stringify(config), { qos: 1, retain: true })
-    .on("message", (topic, message) => {
-      if (topic === `${root}/execute`) {
-        console.log("Refreshing webview...");
-        hardware.setDisplayStatus("ON");
-        WEBVIEW.view.webContents.reloadIgnoringCache();
-      }
-    })
-    .subscribe(`${root}/execute`);
-};
-
-/**
- * Initializes the kiosk select status and handles the execute logic.
- *
- * @param {Object} client - Instance of the mqtt client.
- */
-const initKiosk = (client) => {
-  const root = `${INTEGRATION.discovery}/select/${INTEGRATION.node}/kiosk`;
-  const config = {
-    name: `Kiosk`,
-    unique_id: `${INTEGRATION.node}_kiosk`,
-    command_topic: `${root}/set`,
-    state_topic: `${root}/status`,
-    value_template: "{{ value }}",
-    options: ["Framed", "Fullscreen", "Maximized", "Minimized", "Terminated"],
-    icon: "mdi:overscan",
-    device: INTEGRATION.device,
-  };
-  client
-    .publish(`${root}/config`, JSON.stringify(config), { qos: 1, retain: true })
-    .on("message", (topic, message) => {
-      if (topic === `${root}/set`) {
-        const status = message.toString();
-        console.log("Set Kiosk Status:", status);
-        hardware.setDisplayStatus("ON");
-        switch (status) {
-          case "Framed":
-            WEBVIEW.window.restore();
-            WEBVIEW.window.unmaximize();
-            WEBVIEW.window.setFullScreen(false);
-            break;
-          case "Fullscreen":
-            WEBVIEW.window.restore();
-            WEBVIEW.window.unmaximize();
-            WEBVIEW.window.setFullScreen(true);
-            break;
-          case "Maximized":
-            WEBVIEW.window.restore();
-            WEBVIEW.window.setFullScreen(false);
-            WEBVIEW.window.maximize();
-            break;
-          case "Minimized":
-            WEBVIEW.window.restore();
-            WEBVIEW.window.setFullScreen(false);
-            WEBVIEW.window.minimize();
-            break;
-          case "Terminated":
-            app.quit();
-        }
-      }
-    })
-    .subscribe(`${root}/set`);
-  updateKiosk(client);
-};
-
-/**
- * Updates the kiosk status via the mqtt connection.
- *
- * @param {Object} client - Instance of the mqtt client.
- */
-const updateKiosk = (client) => {
-  const kiosk = WEBVIEW.status;
-  const root = `${INTEGRATION.discovery}/select/${INTEGRATION.node}/kiosk`;
-  if (kiosk !== null) {
-    client.publish(`${root}/status`, `${kiosk}`, { qos: 1, retain: true });
-  }
-};
-
-/**
- * Initializes the display status, brightness and handles the execute logic.
- *
- * @param {Object} client - Instance of the mqtt client.
- */
-const initDisplay = (client) => {
-  const root = `${INTEGRATION.discovery}/light/${INTEGRATION.node}/display`;
-  const config = {
-    name: `Display`,
-    unique_id: `${INTEGRATION.node}_display`,
-    command_topic: `${root}/set`,
-    state_topic: `${root}/status`,
-    icon: "mdi:monitor-shimmer",
-    platform: "light",
-    device: INTEGRATION.device,
-  };
-  if (HARDWARE.display.brightness.path !== null) {
-    config.brightness_scale = 100;
-    config.brightness_command_topic = `${root}/brightness/set`;
-    config.brightness_state_topic = `${root}/brightness/status`;
-  }
-  client
-    .publish(`${root}/config`, JSON.stringify(config), { qos: 1, retain: true })
-    .on("message", (topic, message) => {
-      if (topic === `${root}/set`) {
-        const status = message.toString();
-        console.log("Set Display Status:", status);
-        hardware.setDisplayStatus(status);
-      } else if (topic === `${root}/brightness/set`) {
-        const brightness = parseInt(message, 10);
-        console.log("Set Display Brightness:", brightness);
-        hardware.setDisplayBrightness(brightness);
-      }
-    })
-    .subscribe(`${root}/set`)
-    .subscribe(`${root}/brightness/set`);
-  updateDisplay(client);
-};
-
-/**
- * Updates the display status, brightness via the mqtt connection.
- *
- * @param {Object} client - Instance of the mqtt client.
- */
-const updateDisplay = (client) => {
-  const status = hardware.getDisplayStatus();
-  const brightness = hardware.getDisplayBrightness();
-  const root = `${INTEGRATION.discovery}/light/${INTEGRATION.node}/display`;
-  if (status !== null) {
-    client.publish(`${root}/status`, `${status}`, { qos: 1, retain: true });
-  }
-  if (brightness !== null) {
-    client.publish(`${root}/brightness/status`, `${brightness}`, { qos: 1, retain: true });
-  }
-};
-
-/**
- * Initializes the model sensor.
- *
- * @param {Object} client - Instance of the mqtt client.
- */
-const initModel = (client) => {
-  const root = `${INTEGRATION.discovery}/sensor/${INTEGRATION.node}/model`;
-  const config = {
-    name: `Model`,
-    unique_id: `${INTEGRATION.node}_model`,
-    state_topic: `${root}/status`,
-    value_template: "{{ value }}",
-    icon: "mdi:raspberry-pi",
-    device: INTEGRATION.device,
-  };
-  client.publish(`${root}/config`, JSON.stringify(config), { qos: 1, retain: true });
-  updateModel(client);
-};
-
-/**
- * Updates the model sensor via the mqtt connection.
- *
- * @param {Object} client - Instance of the mqtt client.
- */
-const updateModel = (client) => {
-  const model = hardware.getModel();
-  const root = `${INTEGRATION.discovery}/sensor/${INTEGRATION.node}/model`;
-  if (model !== null) {
-    client.publish(`${root}/status`, `${model}`, { qos: 1, retain: true });
-  }
-};
-
-/**
- * Initializes the serial number sensor.
- *
- * @param {Object} client - Instance of the mqtt client.
- */
-const initSerialNumber = (client) => {
-  const root = `${INTEGRATION.discovery}/sensor/${INTEGRATION.node}/serial_number`;
-  const config = {
-    name: `Serial Number`,
-    unique_id: `${INTEGRATION.node}_serial_number`,
-    state_topic: `${root}/status`,
-    value_template: "{{ value }}",
-    icon: "mdi:hexadecimal",
-    device: INTEGRATION.device,
-  };
-  client.publish(`${root}/config`, JSON.stringify(config), { qos: 1, retain: true });
-  updateSerialNumber(client);
-};
-
-/**
- * Updates the serial number sensor via the mqtt connection.
- *
- * @param {Object} client - Instance of the mqtt client.
- */
-const updateSerialNumber = (client) => {
-  const serialNumber = hardware.getSerialNumber();
-  const root = `${INTEGRATION.discovery}/sensor/${INTEGRATION.node}/serial_number`;
-  if (serialNumber !== null) {
-    client.publish(`${root}/status`, `${serialNumber}`, { qos: 1, retain: true });
-  }
-};
-
-/**
- * Initializes the host name sensor.
- *
- * @param {Object} client - Instance of the mqtt client.
- */
-const initHostName = (client) => {
-  const root = `${INTEGRATION.discovery}/sensor/${INTEGRATION.node}/host_name`;
-  const config = {
-    name: `Host Name`,
-    unique_id: `${INTEGRATION.node}_host_name`,
-    state_topic: `${root}/status`,
-    value_template: "{{ value }}",
-    icon: "mdi:console-network",
-    device: INTEGRATION.device,
-  };
-  client.publish(`${root}/config`, JSON.stringify(config), { qos: 1, retain: true });
-  updateHostName(client);
-};
-
-/**
- * Updates the host name sensor via the mqtt connection.
- *
- * @param {Object} client - Instance of the mqtt client.
- */
-const updateHostName = (client) => {
-  const hostName = hardware.getHostName();
-  const root = `${INTEGRATION.discovery}/sensor/${INTEGRATION.node}/host_name`;
-  if (hostName !== null) {
-    client.publish(`${root}/status`, `${hostName}`, { qos: 1, retain: true });
-  }
-};
-
-/**
- * Initializes the up time sensor.
- *
- * @param {Object} client - Instance of the mqtt client.
- */
-const initUpTime = (client) => {
-  const root = `${INTEGRATION.discovery}/sensor/${INTEGRATION.node}/up_time`;
-  const config = {
-    name: `Up Time`,
-    unique_id: `${INTEGRATION.node}_up_time`,
-    state_topic: `${root}/status`,
-    value_template: "{{ (value | float) | round(0) }}",
-    unit_of_measurement: "min",
-    icon: "mdi:timeline-clock",
-    device: INTEGRATION.device,
-  };
-  client.publish(`${root}/config`, JSON.stringify(config), { qos: 1, retain: true });
-  updateUpTime(client);
-};
-
-/**
- * Updates the up time sensor via the mqtt connection.
- *
- * @param {Object} client - Instance of the mqtt client.
- */
-const updateUpTime = (client) => {
-  const upTime = hardware.getUpTime();
-  const root = `${INTEGRATION.discovery}/sensor/${INTEGRATION.node}/up_time`;
-  if (upTime !== null) {
-    client.publish(`${root}/status`, `${upTime}`, { qos: 1, retain: true });
-  }
-};
-
-/**
- * Initializes the memory size sensor.
- *
- * @param {Object} client - Instance of the mqtt client.
- */
-const initMemorySize = (client) => {
-  const root = `${INTEGRATION.discovery}/sensor/${INTEGRATION.node}/memory_size`;
-  const config = {
-    name: `Memory Size`,
-    unique_id: `${INTEGRATION.node}_memory_size`,
-    state_topic: `${root}/status`,
-    value_template: "{{ (value | float) | round(2) }}",
-    unit_of_measurement: "GiB",
-    icon: "mdi:memory",
-    device: INTEGRATION.device,
-  };
-  client.publish(`${root}/config`, JSON.stringify(config), { qos: 1, retain: true });
-  updateMemorySize(client);
-};
-
-/**
- * Updates the memory size sensor via the mqtt connection.
- *
- * @param {Object} client - Instance of the mqtt client.
- */
-const updateMemorySize = (client) => {
-  const memorySize = hardware.getMemorySize();
-  const root = `${INTEGRATION.discovery}/sensor/${INTEGRATION.node}/memory_size`;
-  if (memorySize !== null) {
-    client.publish(`${root}/status`, `${memorySize}`, { qos: 1, retain: true });
-  }
-};
-
-/**
- * Initializes the memory usage sensor.
- *
- * @param {Object} client - Instance of the mqtt client.
- */
-const initMemoryUsage = (client) => {
-  const root = `${INTEGRATION.discovery}/sensor/${INTEGRATION.node}/memory_usage`;
-  const config = {
-    name: `Memory Usage`,
-    unique_id: `${INTEGRATION.node}_memory_usage`,
-    state_topic: `${root}/status`,
-    value_template: "{{ (value | float) | round(0) }}",
-    unit_of_measurement: "%",
-    icon: "mdi:memory-arrow-down",
-    device: INTEGRATION.device,
-  };
-  client.publish(`${root}/config`, JSON.stringify(config), { qos: 1, retain: true });
-  updateMemoryUsage(client);
-};
-
-/**
- * Updates the memory usage sensor via the mqtt connection.
- *
- * @param {Object} client - Instance of the mqtt client.
- */
-const updateMemoryUsage = (client) => {
-  const memoryUsage = hardware.getMemoryUsage();
-  const root = `${INTEGRATION.discovery}/sensor/${INTEGRATION.node}/memory_usage`;
-  if (memoryUsage !== null) {
-    client.publish(`${root}/status`, `${memoryUsage}`, { qos: 1, retain: true });
-  }
-};
-
-/**
- * Initializes the processor usage sensor.
- *
- * @param {Object} client - Instance of the mqtt client.
- */
-const initProcessorUsage = (client) => {
-  const root = `${INTEGRATION.discovery}/sensor/${INTEGRATION.node}/processor_usage`;
-  const config = {
-    name: `Processor Usage`,
-    unique_id: `${INTEGRATION.node}_processor_usage`,
-    state_topic: `${root}/status`,
-    value_template: "{{ (value | float) | round(0) }}",
-    unit_of_measurement: "%",
-    icon: "mdi:cpu-64-bit",
-    device: INTEGRATION.device,
-  };
-  client.publish(`${root}/config`, JSON.stringify(config), { qos: 1, retain: true });
-  updateProcessorUsage(client);
-};
-
-/**
- * Updates the processor usage sensor via the mqtt connection.
- *
- * @param {Object} client - Instance of the mqtt client.
- */
-const updateProcessorUsage = (client) => {
-  const processorUsage = hardware.getProcessorUsage();
-  const root = `${INTEGRATION.discovery}/sensor/${INTEGRATION.node}/processor_usage`;
-  if (processorUsage !== null) {
-    client.publish(`${root}/status`, `${processorUsage}`, { qos: 1, retain: true });
-  }
-};
-
-/**
- * Initializes the processor temperature sensor.
- *
- * @param {Object} client - Instance of the mqtt client.
- */
-const initProcessorTemperature = (client) => {
-  const root = `${INTEGRATION.discovery}/sensor/${INTEGRATION.node}/processor_temperature`;
-  const config = {
-    name: `Processor Temperature`,
-    unique_id: `${INTEGRATION.node}_processor_temperature`,
-    state_topic: `${root}/status`,
-    value_template: "{{ (value | float) | round(0) }}",
-    unit_of_measurement: "°C",
-    icon: "mdi:radiator",
-    device: INTEGRATION.device,
-  };
-  client.publish(`${root}/config`, JSON.stringify(config), { qos: 1, retain: true });
-  updateProcessorTemperature(client);
-};
-
-/**
- * Updates the processor temperature sensor via the mqtt connection.
- *
- * @param {Object} client - Instance of the mqtt client.
- */
-const updateProcessorTemperature = (client) => {
-  const processorTemperature = hardware.getProcessorTemperature();
-  const root = `${INTEGRATION.discovery}/sensor/${INTEGRATION.node}/processor_temperature`;
-  if (processorTemperature !== null) {
-    client.publish(`${root}/status`, `${processorTemperature}`, { qos: 1, retain: true });
-  }
-};
-
-/**
- * Initializes the heartbeat sensor.
- *
- * @param {Object} client - Instance of the mqtt client.
- */
-const initHeartbeat = (client) => {
-  const root = `${INTEGRATION.discovery}/sensor/${INTEGRATION.node}/heartbeat`;
-  const config = {
-    name: `Heartbeat`,
-    unique_id: `${INTEGRATION.node}_heartbeat`,
-    state_topic: `${root}/status`,
-    value_template: "{{ value }}",
-    icon: "mdi:heart-flash",
-    device: INTEGRATION.device,
-  };
-  client.publish(`${root}/config`, JSON.stringify(config), { qos: 1, retain: true });
-  updateHeartbeat(client);
-};
-
-/**
- * Updates the heartbeat sensor via the mqtt connection.
- *
- * @param {Object} client - Instance of the mqtt client.
- */
-const updateHeartbeat = (client) => {
-  const now = new Date();
-  const local = new Date(now.getTime() - now.getTimezoneOffset() * 60 * 1000);
-  const heartbeat = local.toISOString().replace(/\.\d{3}Z$/, "");
-  const root = `${INTEGRATION.discovery}/sensor/${INTEGRATION.node}/heartbeat`;
-  client.publish(`${root}/status`, `${heartbeat}`, { qos: 1, retain: true });
-};
-
-module.exports = {
-  init,
-  update,
-};
@@ -1,164 +0,0 @@
-const path = require("path");
-const hardware = require("./hardware");
-const integration = require("./integration");
-const { app, nativeTheme, BaseWindow, WebContentsView } = require("electron");
-
-global.WEBVIEW = global.WEBVIEW || {
-  initialized: false,
-  status: "offline",
-  locked: false,
-};
-
-/**
- * Initializes the webview with the provided arguments.
- *
- * @param {Object} args - The command-line arguments to customize the initialization process.
- * @returns {boolean} Returns true if the initialization was successful.
- */
-const init = async (args) => {
-  if (!args.web_url) {
-    console.error("Please provide the '--web-url' parameter");
-    return app.quit();
-  }
-  const url = new URL(args.web_url);
-  const theme = args.web_theme ? args.web_theme : "dark";
-  const zoom = args.web_zoom ? parseFloat(args.web_zoom) : 1.25;
-
-  // Init global root window
-  nativeTheme.themeSource = theme;
-  WEBVIEW.window = new BaseWindow({
-    title: `TouchKio - ${url.host}`,
-    icon: path.join(__dirname, "..", "img", "icon.png"),
-  });
-  WEBVIEW.window.setMenuBarVisibility(false);
-  WEBVIEW.window.setFullScreen(true);
-
-  // Init global main webview
-  WEBVIEW.view = new WebContentsView();
-  WEBVIEW.window.contentView.addChildView(WEBVIEW.view);
-  WEBVIEW.view.webContents.loadURL(url.toString());
-
-  // Register events
-  windowEvents(WEBVIEW.window, zoom);
-  viewEvents(WEBVIEW.view);
-
-  return true;
-};
-
-/**
- * Updates the shared webview properties.
- */
-const update = () => {
-  if (!WEBVIEW.initialized) {
-    return;
-  }
-
-  // Update window status
-  if (WEBVIEW.window.isFullScreen()) {
-    WEBVIEW.status = "Fullscreen";
-  } else if (WEBVIEW.window.isMinimized()) {
-    WEBVIEW.status = "Minimized";
-  } else if (WEBVIEW.window.isMaximized()) {
-    WEBVIEW.status = "Maximized";
-  } else {
-    WEBVIEW.status = "Framed";
-  }
-
-  // Update integration sensor
-  console.log("Update Kiosk Status:", WEBVIEW.status);
-  integration.update();
-};
-
-/**
- * Register window events and handler.
- *
- * @param {Object} window - The root window object.
- * @param {number} zoom - Zoom level used for the webview.
- */
-const windowEvents = (window, zoom) => {
-  // Handle window resize for webview bounds
-  const resize = () => {
-    const { width, height } = window.getBounds();
-    WEBVIEW.view.setBounds({ x: 0, y: 0, width: width, height: height });
-    WEBVIEW.view.webContents.setZoomFactor(zoom);
-  };
-  window.on("ready-to-show", resize);
-  window.on("resize", resize);
-  resize();
-
-  // Handle focus change for webview lock
-  HARDWARE.display.notifiers.push(() => {
-    WEBVIEW.locked = hardware.getDisplayStatus() === "OFF";
-    if (WEBVIEW.locked) {
-      window.blur();
-    }
-    /* This also works, but it doesn't allow to react for screen wake up.
-    window.setIgnoreMouseEvents(hardware.getDisplayStatus() === "OFF");
-    */
-  });
-  window.on("focus", () => {
-    if (WEBVIEW.locked) {
-      hardware.setDisplayStatus("ON");
-      window.blur();
-    }
-    WEBVIEW.locked = false;
-  });
-
-  // Handle window status updates
-  window.on("minimize", update);
-  window.on("restore", update);
-  window.on("maximize", update);
-  window.on("unmaximize", update);
-  window.on("enter-full-screen", update);
-  window.on("leave-full-screen", update);
-
-  // Handle signal and exit events
-  process.on("SIGINT", app.quit);
-  app.on("before-quit", () => {
-    WEBVIEW.status = "Terminated";
-    integration.update();
-  });
-
-  // Handle multiple instances
-  app.on("second-instance", () => {
-    if (window.isMinimized()) {
-      window.restore();
-    }
-    window.focus();
-  });
-};
-
-/**
- * Register webview events and handler.
- *
- * @param {Object} view - The main webview object.
- */
-const viewEvents = (view) => {
-  // Enable webview touch emulation
-  view.webContents.debugger.attach("1.1");
-  view.webContents.debugger.sendCommand("Emulation.setEmitTouchEventsForMouse", {
-    enabled: true,
-    configuration: "mobile",
-  });
-
-  // Disable webview hyperlinks
-  view.webContents.setWindowOpenHandler(() => {
-    return { action: "deny" };
-  });
-
-  // Remove webview scrollbar
-  view.webContents.on("dom-ready", () => {
-    view.webContents.insertCSS("::-webkit-scrollbar { display: none; }");
-  });
-
-  // Webview fully loaded
-  view.webContents.on("did-finish-load", () => {
-    WEBVIEW.initialized = true;
-    update();
-  });
-};
-
-module.exports = {
-  init,
-  update,
-};
Author	SHA1	Message	Date
Loutt	099fe5a714	fix: touch event ignored #148	2025-12-15 11:13:12 +01:00
leukipp	b63f2aee34	build: update version	2025-12-09 16:30:40 +01:00
leukipp	9d88a9ba38	docs: update readme	2025-12-09 16:11:48 +01:00
leukipp	bae0ef26fe	fix: validation rejection type error #147	2025-12-09 15:51:49 +01:00
leukipp	f0438d7c88	fix: service stop timeout #159	2025-12-09 15:49:51 +01:00
leukipp	f46649780c	fix: check cache folder exists #161	2025-12-09 13:53:23 +01:00
leukipp	73edbaedb7	fix: mqtt reconnect state #153	2025-12-07 15:59:23 +01:00
leukipp	3b150fc540	fix: keep old log files #140	2025-12-07 15:08:49 +01:00
leukipp	7c96fbf427	docs: update hardware	2025-12-07 14:52:10 +01:00
leukipp	fc31721ae0	docs: update issue templates	2025-12-07 12:27:01 +01:00
leukipp	fb841cce14	docs: update readme	2025-12-07 12:20:23 +01:00
leukipp	d5caffe9fd	docs: update issue templates	2025-12-07 12:19:20 +01:00
leukipp	2442d4a681	docs: rename yaml files	2025-12-07 12:08:34 +01:00
leukipp	ab0c1284fb	docs: add issue templates	2025-12-07 11:46:44 +01:00
leukipp	55e528d95b	docs: update readme	2025-12-01 19:12:46 +01:00
leukipp	ffcc9517f2	docs: update readme	2025-12-01 16:31:09 +01:00
leukipp	3ea4921861	docs: update hardware	2025-12-01 16:30:58 +01:00
leukipp	1e91b7aa27	build: update version	2025-12-01 08:57:00 +01:00
leukipp	eb4b101f45	docs: update hardware	2025-12-01 08:55:38 +01:00
leukipp	290e524901	build: update dependencies	2025-11-27 07:47:06 +01:00
leukipp	4b010925ed	docs: update readme	2025-11-26 16:51:15 +01:00
Loryan Strant	910001f0e1	Add DNS resolution notes to README (#134 ) * Add DNS resolution notes to README Added DNS resolution notes and instructions for using system resolver.	2025-11-26 15:11:41 +01:00
leukipp	61628b1864	feat: add mqtt screenshot image #133	2025-11-25 17:12:43 +01:00
leukipp	1a79ffd855	feat: ddcutil display brightness support #101	2025-11-14 14:39:27 +01:00
leukipp	5423239e62	fix: handle renderer crashes #115	2025-11-14 14:02:15 +01:00
leukipp	44a4fa9d2d	ref: allow null logging	2025-11-11 11:35:59 +01:00
leukipp	26494e6844	fix: handle invalid file read #113	2025-11-10 19:36:29 +01:00
leukipp	4f8a9c307c	fix: graceful quit on shutdown #125	2025-11-10 14:46:15 +01:00
leukipp	a3860ebd69	feat: remember zoom and theme per page #108	2025-11-10 11:25:53 +01:00
leukipp	b3a787d03d	ref: register argument updates	2025-11-10 11:21:33 +01:00
leukipp	41e4c2d434	ref: integer parsing	2025-11-10 11:20:36 +01:00
leukipp	77cb962e6f	ref: app exit codes	2025-10-30 14:31:49 +01:00
leukipp	c85055a222	feat: improved swipe paging #64	2025-10-30 14:30:53 +01:00
leukipp	81b4c30aa2	fix: window race conditions #102	2025-10-27 16:26:20 +01:00
leukipp	e6d8c537f2	ref: whoopsie logging	2025-10-27 16:21:22 +01:00
leukipp	0c51c1c1ff	ref: content security policy	2025-10-26 13:46:21 +01:00
leukipp	45ea309f3b	ref: add debug logging	2025-10-26 13:44:59 +01:00
leukipp	e195a56739	build: update version	2025-10-10 21:29:38 +02:00
leukipp	d86a5385a8	docs: update readme	2025-10-10 19:11:29 +02:00
leukipp	3ce1265c8a	docs: update hardware	2025-10-10 19:10:43 +02:00
leukipp	c2bf551834	ref: update images	2025-10-10 19:08:29 +02:00
leukipp	785a97721a	build: update dependencies	2025-10-09 14:19:57 +02:00
leukipp	05c9d98b61	feat: add mqtt version diagnostic #91	2025-10-09 13:43:20 +02:00
leukipp	9c26d9d8bb	ref: add mqtt attributes	2025-10-09 13:09:30 +02:00
leukipp	ad7d3fd3ff	feat: early app updates #96	2025-10-08 20:47:59 +02:00
leukipp	f666ed57ab	ref: widget focus handling	2025-10-08 20:13:48 +02:00
leukipp	c0b1a6e9ce	feat: add mqtt error diagnostic #91	2025-10-07 21:48:49 +02:00
leukipp	19e51e349c	fix: use mqtt last will #84	2025-10-07 09:59:48 +02:00
leukipp	5d012bd637	feat: extended theme switching #87	2025-10-07 09:17:57 +02:00
leukipp	01c7411ddc	feat: use box for mqtt zoom #90	2025-10-06 19:17:35 +02:00
leukipp	3e4d96536f	feat: dynamic status bar #94	2025-10-06 18:55:51 +02:00
leukipp	4bcb2c4e89	feat: auto on-screen keyboard #85	2025-09-30 21:26:39 +02:00
leukipp	b2b87888e4	ref: keyboard window status handling	2025-09-30 17:31:00 +02:00
leukipp	164ef2838c	docs: add sponsor	2025-09-29 10:20:40 +02:00
leukipp	ae2633800d	ref: allow electron flags	2025-09-29 10:10:12 +02:00
leukipp	552f0e19a4	feat: mqtt audio volume control #82	2025-09-26 13:47:15 +02:00
leukipp	890c84d69d	Merge branch 'develop' of https://github.com/leukipp/touchkio into develop	2025-09-21 22:47:10 +02:00
leukipp	ac69dee387	ref: improve error handling	2025-09-21 22:47:02 +02:00
leukipp	ac62dc17ce	build: update version	2025-09-19 22:07:45 +02:00
leukipp	f2f80e7d52	fix: mqtt config removal #79	2025-09-19 22:07:14 +02:00
leukipp	10e7ff078a	build: update version	2025-09-19 16:49:12 +02:00
leukipp	e677fff160	docs: update readme	2025-09-19 16:36:57 +02:00
leukipp	63db26611e	build: update dependencies	2025-09-19 15:57:13 +02:00
leukipp	5ec6577b5a	fix: option to ignore certificate errors #76	2025-09-19 15:52:09 +02:00
leukipp	0359742e70	docs: update readme	2025-09-11 08:55:00 +02:00
leukipp	b70f4074e5	docs: add hardware	2025-09-10 16:43:24 +02:00
leukipp	a4c300407b	ref: remove unsupported mqtt config	2025-09-10 16:00:26 +02:00
leukipp	758f64ced4	ref: add cpu thermal zone	2025-09-10 15:49:22 +02:00
leukipp	7ab803d4ca	ref: app update summary	2025-09-09 20:50:56 +02:00
leukipp	092697850d	build: compress zip	2025-09-09 19:59:30 +02:00
leukipp	422e92dd89	build: update version	2025-09-09 19:41:09 +02:00
leukipp	a15c0fc91d	docs: update readme	2025-09-09 19:33:33 +02:00
leukipp	358fa3ca9c	ref: use display status callback	2025-09-09 17:25:56 +02:00
leukipp	10722fa217	build: update build.json	2025-09-08 21:31:01 +02:00
leukipp	7267fafb97	ref: add console logs	2025-09-08 20:03:23 +02:00
leukipp	b5e95936dc	ref: obfuscate logged password	2025-09-08 18:58:29 +02:00
leukipp	047b38a41b	feat: extended logging #73	2025-09-08 17:31:42 +02:00
leukipp	a93fbb2ad3	build: update dependencies	2025-09-08 17:18:16 +02:00
leukipp	0b927a3ef6	fix: touch event handling for inactive screens #61	2025-09-08 16:23:04 +02:00
leukipp	d35cf27de9	fix: update last active only on touch #71	2025-09-08 09:56:27 +02:00
leukipp	19348b4b60	build: disable zip update	2025-09-06 20:27:01 +02:00
leukipp	ce1eed391d	build: update version	2025-09-06 20:08:16 +02:00
leukipp	fe6fe92656	docs: update readme	2025-09-06 20:07:41 +02:00
leukipp	3aea938cfb	fix: validate arguments file #69	2025-09-06 20:03:49 +02:00
leukipp	c39428fa42	build: update build.json	2025-09-06 19:48:02 +02:00
leukipp	7caa5bfc8a	ref: update images	2025-09-06 19:22:19 +02:00
leukipp	5f69961a9f	feat: mqtt app update #70	2025-09-06 19:21:51 +02:00
leukipp	f44d998016	build: improve update logic	2025-09-06 19:07:57 +02:00
leukipp	3ea65a4af8	build: update dependencies	2025-09-06 19:04:16 +02:00
leukipp	2ad49c3167	feat: add network address mqtt sensor #66	2025-09-03 22:13:45 +02:00
leukipp	ef2093a25e	feat: check sudo rights for mqtt #62	2025-09-03 16:01:47 +02:00
leukipp	2737eabd8a	fix: mqtt keyboard state #65	2025-09-01 17:22:26 +02:00
leukipp	b8f809c50e	build: update version	2025-08-31 22:04:56 +02:00
leukipp	c3e625a8f6	docs: update readme	2025-08-31 22:01:18 +02:00
leukipp	7c15707e3b	docs: add hardware	2025-08-31 21:06:57 +02:00
leukipp	dbd3756793	ref: update images	2025-08-31 20:33:07 +02:00
leukipp	85fe5a910a	fix: update service file #62	2025-08-31 20:31:38 +02:00
leukipp	d78088e6af	feat: side panel pager #46	2025-08-31 19:24:50 +02:00
leukipp	bf77d9b2a0	fix: mqtt memory leak #63	2025-08-31 16:09:39 +02:00
leukipp	f4ca7bc412	feat: basic keyboard navigation #46	2025-08-31 11:41:12 +02:00
leukipp	d0ea377ead	feat: add page zoom buttons #48	2025-08-31 09:24:30 +02:00
leukipp	9a829f72e3	build: update dependencies	2025-08-31 08:48:24 +02:00
leukipp	482a56c9b9	build: update dependencies	2025-08-27 20:03:26 +02:00
leukipp	32409983b2	fix: remember zoom level on refresh #52	2025-08-27 20:02:59 +02:00
leukipp	fe0667919e	feat: check online status #62	2025-08-27 18:30:15 +02:00
leukipp	0037a892cd	ref: display status fallback	2025-08-27 18:26:40 +02:00
leukipp	ad22dd3215	feat: kde wayland support #57	2025-08-26 17:15:21 +02:00
leukipp	619179c3c8	fix: event based communication #39 #48 #55	2025-08-25 18:52:25 +02:00
afsy-d	7e5e669b09	Added hardware information (#56 ) * Update HARDWARE.md Added CM4 light 2GB information * Update HARDWARE.md Updated information regarding CM4	2025-08-25 13:31:51 +02:00
Tom Carpenter	437c4ab1c5	Make Webview Zoom Changeable from Home Assistant (#52 ) * Add Page Zoom Control Adds MQTT discovery for a "Page Zoom" input to control the `WEBVIEW.viewZoom` parameter. The MQTT value has been configured to be in % which is then converted to a scale factor when assigned or read from `WEBVIEW.viewZoom`. * Correct Type for page_zoom publishConfig Accidentally replaced "number" with "zoom" when changing paramters. * Add updateZoom Functionality to webview Add a setter function for the viewZoom property that updates the zoom factor for all views when the property is changed.	2025-08-25 13:31:28 +02:00
leukipp	ea01876ea7	build: update version	2025-07-10 21:31:48 +02:00
leukipp	9de170ce6c	docs: update readme	2025-07-10 21:16:52 +02:00
leukipp	6b3e89d522	build: update dependencies	2025-07-10 21:15:19 +02:00
leukipp	cbfd0538e7	feat: auto-hide navigation bar #45	2025-07-10 20:54:32 +02:00
leukipp	d3af6d397e	docs: add hardware	2025-07-10 13:58:32 +02:00
leukipp	dd81da204e	ref: update images	2025-07-10 13:23:53 +02:00
leukipp	00aef6402e	fix: use apt instead of dpkg #28	2025-07-09 20:21:24 +02:00
leukipp	a36c624601	ref: show version info	2025-07-09 20:20:07 +02:00
leukipp	adbc214f4d	feat: battery power level over mqtt #33	2025-07-09 19:14:36 +02:00
leukipp	e64f092f6c	ref: navigation buttons	2025-07-09 16:11:28 +02:00
leukipp	cab2052477	ref: move and rename mqtt topics	2025-07-08 19:40:43 +02:00
leukipp	0d66d104fb	fix: command line single arguments #40	2025-07-08 19:24:14 +02:00
leukipp	1afe335379	feat: multi webpage support #25	2025-07-08 14:20:19 +02:00
Miha Frangež	568be07043	Fix for URL containing query params (#40 )	2025-07-06 16:21:37 +02:00
leukipp	9d70b09358	ref: update data types	2025-06-25 14:10:10 +02:00
leukipp	6570d5c00e	fix: return default values #39	2025-06-24 11:15:56 +02:00
leukipp	af7d0c58ce	fix: show web url error #34	2025-06-24 10:59:32 +02:00
leukipp	aed79ab519	build: update version	2025-02-23 22:32:18 +01:00
leukipp	e2397bad65	ref: update status values	2025-02-23 22:31:31 +01:00
leukipp	e7622bef17	ref: use null status	2025-02-23 22:18:25 +01:00
leukipp	2553f52983	build: downgrade dependencies	2025-02-23 22:15:36 +01:00
leukipp	30b5ec2d8b	docs: add hardware	2025-02-23 21:13:50 +01:00
leukipp	94c7e34706	docs: update readme	2025-02-23 20:54:02 +01:00
leukipp	09dda65333	ref: start touchkio	2025-02-23 20:29:23 +01:00
leukipp	99f465a044	build: update dependencies	2025-02-23 20:18:26 +01:00
leukipp	02d1309345	Merge branch 'main' into develop	2025-02-23 16:48:19 +01:00
Sebastian	3142606d12	Update README.md (#20 ) Adding info on how to control the automatically created service	2025-02-23 16:46:30 +01:00
leukipp	51189e8595	fix: reduce file system read cycle #19	2025-02-23 16:45:40 +01:00
leukipp	71a9d4c1de	ref: code cleanup	2025-02-23 16:38:23 +01:00
leukipp	f022db9478	ref: use async update	2025-02-23 15:15:06 +01:00
leukipp	fcc0e5813e	feat: check for DISPLAY variable #12	2025-02-23 13:36:46 +01:00
leukipp	6d23efd713	ref: add debug arguments	2025-02-23 13:01:14 +01:00
leukipp	a37226fd39	build: update version	2025-02-03 09:14:12 +01:00
leukipp	9b8067a598	docs: update readme	2025-02-03 09:10:46 +01:00
leukipp	257dab8d7f	docs: add hardware	2025-02-02 23:49:41 +01:00
Rajeevan	ff4b9d1262	Update HARDWARE.md (#14 ) Adding my 10.1inch display that works.. tested uinsg X11, Wayland (Wayfire & Labwc)	2025-02-02 22:41:53 +01:00
leukipp	757ba9ff92	docs: update docs	2025-02-02 22:38:06 +01:00
leukipp	ed3bad7292	ref: update images	2025-02-02 22:30:39 +01:00
leukipp	f00a49e4e4	feat: side panel widget #16	2025-02-02 20:28:22 +01:00
leukipp	bbe20fef8f	ref: code cleanup	2025-02-02 16:22:07 +01:00
leukipp	cfbc391a52	build: rename artifacts	2025-01-10 22:41:42 +01:00
leukipp	b1998ceea9	build: update version	2025-01-10 22:31:22 +01:00
leukipp	081cee2990	docs: update docs	2025-01-10 22:30:17 +01:00
leukipp	fd746cc79a	feat: additional MQTT controls and sensors #7	2025-01-10 17:11:11 +01:00
leukipp	4f426df4e6	build: use x64 names	2025-01-09 17:14:19 +01:00
leukipp	7084fc8188	build: add amd64 releases	2025-01-09 14:36:09 +01:00
leukipp	b2685f8d6b	feat: support for x11 and generic linux #5	2025-01-09 13:37:26 +01:00
leukipp	5743b0ff08	Merge pull request #3 from pdsccode/main docs: added working HDMI display to compatibility list #3	2025-01-08 18:05:23 +01:00
pdsccode	a7f4ede899	Added working HDMI-Display to compatibility list	2025-01-08 14:56:10 +01:00