Multi webpage navigation

[leukipp]

Starting with version 1.2.0 multi webpage support #25 was added.

Multiple web urls can be provided by separating them with a comma:

touchkio --web-url=https://demo.home-assistant.io,https://imvbh.github.io/FlipClock

Any existing ~/.config/touchkio/Arguments.json file can also be updated accordingly:

{
  "web_url": [
    "https://demo.home-assistant.io",
    "https://imvbh.github.io/FlipClock"
  ]
}

The old syntax for a single url (string instead of array) is still a valid configuration option:

{
  "web_url": "https://demo.home-assistant.io"
}

---

Navigation

To activate the navigation bar located at the bottom, the side panel widget #16 must be enabled.
If there is no interaction with the screen, the navigation bar will automatically hide after one minute to ensure a clean kiosk window experience.

The goal is not to create a fully featured web browser, only switching between multiple web pages is supported. Advanced tab management (such as opening or closing tabs) is not included. The following controls are available:

• Home: Refreshes the current page.
  • If the current host has been changed (e.g. by following some hyperlinks or typing in another url in the address bar) this button resets the url back to the original provided.
• Pager: Switches to the next page (only visible if multiple urls where provided).
  • If the last page is reached it cycles back to the first provided url.
• Url: Text input for changing the current url.
  • If an address is entered without "http(s)://" the "https://" prefix will be added automatically.
• Backward: Navigates in the browsing history backward.
• Forward: Navigates in the browsing history forward.

Automation

Additional MQTT controls are available to provide enhanced management of the current active page.

• Page Number: Switches between the pages (only usable if multiple urls where provided).
  • The maximum number of pages available is determined by the number of provided --web-url(s).
• Page Url: Shows the current url for the active page number.
  • An update on the page url field will also change the current url on the kiosk device.