Feature: Kiosk Mode (3/7) - Screensaver Views #4199
Closed
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Part 1 of Kiosk Mode implementation. This PR adds the foundation for Kiosk Mode: ## KioskSettings.swift - Complete settings model with all configuration options - Codable for persistence - Includes enums for screensaver modes, clock styles, photo sources, etc. - Entity trigger configurations - Dashboard rotation settings ## KioskConstants.swift - Centralized constants for animations, timing, notifications - Notification names for kiosk events ## Utilities - IconMapper: Converts MDI icons to SF Symbols - TouchFeedbackManager: Haptic and audio feedback - AnimationUtilities: Shared animation helpers These types form the foundation that subsequent PRs will build upon.
Part 2 of Kiosk Mode implementation. Depends on PR home-assistant#4197. ## KioskModeManager (~970 lines) Central coordinator for all kiosk functionality: - Enable/disable kiosk mode - Screen state management (on, dimmed, screensaver) - Brightness control with day/night scheduling - Idle timer and activity tracking - Dashboard navigation - Entity trigger subscriptions - HA WebSocket integration ## Security (~760 lines) - SecurityManager: PIN and biometric authentication - SettingsManager: Settings persistence ## Dashboard (~360 lines) - DashboardManager: Dashboard rotation and scheduling ## Camera Detection (~320 lines) - CameraDetectionManager: Motion and presence detection using front camera ## App Launcher (~360 lines) - AppLauncherManager: Launch external apps, return handling ## WebViewController Integration (~565 lines) - WebViewController+Kiosk: Kiosk overlay management - Modified WebViewController: Made properties internal for kiosk access
Part 3 of Kiosk Mode implementation. Depends on PRs home-assistant#4197 and home-assistant#4198. Adds screensaver functionality with multiple display modes: Files added (~52K): - ClockScreensaverView.swift: Clock display with multiple styles (large, minimal, digital, analog) - CustomURLScreensaverView.swift: Display custom HA dashboard as screensaver - EntityStateProvider.swift: Fetches and formats entity states for display - PhotoManager.swift: Manages photo loading from device, iCloud, and HA media - PhotoScreensaverView.swift: Photo slideshow with transitions - ScreensaverViewController.swift: UIKit controller coordinating screensaver presentation Features: - Multiple screensaver modes: clock, photos, dim, blank, custom URL - Clock styles: large, minimal, digital, analog with entity display - Photo sources: device albums, iCloud, Home Assistant media - Pixel shift for burn-in prevention - Day/night brightness scheduling
nstefanelli
added a commit
to nstefanelli/ha-kiosk
that referenced
this pull request
Jan 9, 2026
Part 4 of Kiosk Mode implementation. Depends on PRs home-assistant#4197, home-assistant#4198, home-assistant#4199. Adds navigation lockdown and overlay UI components: Files added (~39K): - EdgeProtectionView.swift: Invisible edge barriers preventing swipe gestures - QuickActionsView.swift: Quick launch panel for third-party apps - SecretExitGestureView.swift: Hidden gesture sequence to exit kiosk mode - StatusOverlayView.swift: Connection status, battery, and time display Features: - Edge protection blocks iOS system gestures (Control Center, notifications) - Configurable secret tap pattern for secure kiosk exit - Quick actions panel with app shortcuts - Status bar overlay with connection indicator
This was referenced Jan 9, 2026
Contributor
There was a problem hiding this comment.
Pull request overview
This PR adds screensaver display modes and photo management as part 3 of a 7-part kiosk mode feature. It introduces multiple screensaver modes (clock, photos, custom URL, dim, blank) with various display styles, photo slideshow functionality from multiple sources (local, iCloud, Home Assistant media), and integration with the main WebViewController through a comprehensive extension. The changes include ~1,700 lines across screensaver views, photo management, entity state providers, and supporting utilities for animations, feedback, and security.
Reviewed changes
Copilot reviewed 20 out of 20 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| WebViewController.swift | Changed private properties to internal for kiosk mode access; added screensaver integration hooks |
| WebViewController+Kiosk.swift | New comprehensive extension integrating kiosk mode with WebViewController |
| TouchFeedbackManager.swift | New utility for haptic and sound feedback |
| IconMapper.swift | New utility mapping Material Design Icons to SF Symbols |
| AnimationUtilities.swift | New utility providing consistent animation definitions |
| SettingsManager.swift | New manager for settings import/export functionality |
| SecurityManager.swift | New manager for biometric authentication and security features |
| ScreensaverViewController.swift | New controller managing screensaver view lifecycle |
| PhotoScreensaverView.swift | New SwiftUI view for photo slideshow screensaver |
| PhotoManager.swift | New manager handling photo loading from multiple sources |
| EntityStateProvider.swift | New provider for real-time Home Assistant entity states |
| CustomURLScreensaverView.swift | New view displaying custom URL content in WebView |
| ClockScreensaverView.swift | New view displaying clock with multiple styles and entity data |
| KioskSettings.swift | New comprehensive settings model (794 lines) |
| KioskModeManager.swift | New central manager coordinating kiosk functionality (972 lines) |
| KioskConstants.swift | New constants file for consistent values |
| DashboardManager.swift | New manager for dashboard rotation and scheduling |
| CameraDetectionManager.swift | New manager for camera-based motion/presence detection |
| AppLauncherManager.swift | New manager for external app launching |
| project.pbxproj | Xcode project file updates adding new source files |
- Renamed isEnabled to isKioskModeEnabled for clarity - Removed exitPIN (using device-based authentication only) - Changed allowDevicePasscodeExit default to true Co-Authored-By: Claude Opus 4.5 <[email protected]>
Author
|
All review feedback has been addressed:
Ready for re-review. 🙏 |
Author
|
Closing to restructure the PR series. See #4197 for details. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Part 3 of 7 - Screensaver display modes and photo management.
Files Added (~1,700 lines)
ClockScreensaverView.swiftCustomURLScreensaverView.swiftEntityStateProvider.swiftPhotoManager.swiftPhotoScreensaverView.swiftScreensaverViewController.swiftScreensaver Modes
Clock Styles
Photo Sources
Test Plan
PR Series
🤖 Generated with Claude Code