Skip to content

mirkosertic/UltraKiosk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

UltraKiosk

Build

UltraKiosk is a lightweight iOS app that displays Home Assistant in full‑screen kiosk mode. It can also act as a voice satellite. A common use case is a wall‑mounted iPad as a smart display.

Features

  • Full‑screen kiosk-mode display of Home Assistant dashboards (works best with HACS "Kioskmode")
  • Screensaver after inactivity
  • Wake the display via face detection using the device camera
  • Wake-word detection via Picovoice Porcupine
  • Voice satellite for the Home Assistant Voice Pipeline

Screenshots

Start screen / Kiosk WebView Start screen / Kiosk WebView

Settings Settings

Screensaver Screensaver

Installation

  • Open the project in Xcode (UltraKiosk.xcodeproj).
  • Select a target device (iPad/iPhone).
  • Build and install the app on the device.

Requirements:

  • Xcode (latest version)
  • iOS device with camera and network access
  • A reachable Home Assistant instance (local or remote)

Quick Start

  1. Install and launch the app.
  2. Set the Kiosk URL and other options in Settings.
  3. The dashboard loads in full screen; a screensaver starts after inactivity.
  4. The display wakes via local face detection.

Example Kiosk URL:

http://homeassistant.local:8123/anzeige-flur/0?kiosk=true

Configuration

Configuration data is available by tapping three times in the top right corner of the screen. You should also see a small semi-transparent circle there. A configuration dialog will appear, offering the following configuration sections:

Home Assistant

  • IP/Name
  • Port
  • Use HTTPS
  • Access Token

MQTT Integration

  • Enable MQTT
  • Broker IP/Name
  • Port
  • Use TLS/SSL
  • Username (optional)
  • Password (optional)
  • Topic Prefix
  • Battery Update Interval

ScreenSaver

  • Inactivity timeout
  • Screen brightness (dimmed)
  • Screen brightness (normal)
  • Face detection interval

Voice Control

  • Enable voice activation
  • Sample rate
  • Timeout
  • Porcupine Access Token (from Picovoice Console)

Kiosk mode

  • Kiosk URL (optional)

Privacy & Permissions

  • Camera: Used for face detection to wake the display.
  • Microphone: Used for the voice satellite feature (always‑listening when enabled).
  • No biometric data is stored. Face detection is used locally only to activate the display.

Contributing

Contributions are welcome! Please:

  • Open an issue for bugs or feature requests.
  • Submit pull requests with clear descriptions and small, reviewable changes.

License

MIT License. See LICENSE for details.

About

This is a very simple iOS application designed to run HomeAssistant in fullscreen kiosk mode

Topics

Resources

Stars

Watchers

Forks

Contributors

Languages