Roadmap¶

Community-driven feature backlog. Items sourced from GitHub issues and Reddit feedback.

Planned¶

Companion HA Entities¶

Expand Home Assistant Discovery so the tablet appears as a full companion device — not just a brightness/volume MQTT client.

New published entities alongside existing ones:
sensor — uptime (seconds since last boot, via SystemClock.elapsedRealtime())
sensor — app_version (versionName from BuildConfig)
sensor — ip_address (current WiFi IP via WifiManager)
sensor — current_url (URL currently loaded in the WebView; updated on every onPageFinished)
binary_sensor — last_seen (timestamp of last MQTT publish; HA marks unavailable if broker stops receiving)
All entities follow the existing *ConfigMqtt pattern in data-mqtt-impl — new CompanionTelemetryMqtt data class + corresponding MqttPublisher
current_url published reactively: MainViewModel emits URL changes into a StateFlow; MqttService collects and publishes on change with a 1-second debounce
uptime and ip_address refreshed on a configurable interval (default 60 s) alongside the existing battery telemetry ticker
Configurable toggle per entity in Settings → MQTT section so users can opt out of individual sensors

Inactivity Page Reset¶

Automatically navigate back to the configured home URL after the user stops interacting with the dashboard for a configurable period.

Idle timeout (minutes) stored in Proto DataStore; configurable in Settings → WebView section
Touch events forwarded from GeckoView / WebView reset a coroutine-based countdown timer in MainViewModel
On expiry: MainViewModel dispatches a NavigateHome intent that calls loadUrl(homeUrl) — reuses the existing home-URL preference already in DataStore
Timer is paused while the screen is off or the screensaver is active (integrates with MotionService screen-state flow)
Setting of 0 disables the feature entirely
MQTT command inactivity_reset/trigger forces an immediate reset remotely

Volume Button Gesture for Settings¶

Open the control drawer by pressing a physical volume button N times in quick succession — no visible UI required during kiosk operation.

HostActivity.dispatchKeyEvent intercepts KEYCODE_VOLUME_UP / KEYCODE_VOLUME_DOWN; counts presses within a 2-second rolling window
Configurable press count (default 5) stored in DataStore; configurable in Settings → Access section
On threshold reached: emits the same side effect that the FAB press fires — opens the control drawer via AppNavigator
Volume key events consumed only for the gesture; when count is not reached the key event propagates normally to the system
Can be disabled via Settings toggle for deployments that need hardware volume control intact

Time-Based Sleep / Wake Scheduler¶

Define daily on/off rules so the kiosk screen powers down overnight and wakes at a configured time — no Home Assistant automation required.

Data model: list of ScheduleRule(id, type: WAKE|SLEEP, hour, minute, enabled) serialized via kotlinx.serialization and stored in DataStore
AlarmManager.setAlarmClock() used for each active rule; alarms re-registered on ACTION_BOOT_COMPLETED, ACTION_TIME_CHANGED, and ACTION_TIMEZONE_CHANGED
On SLEEP alarm: calls existing DevicePowerManager.dimScreen() → goToSleep() pipeline
On WAKE alarm: calls DevicePowerManager.wakeScreen() + re-arms the next occurrence 24 h later
New sub-screen in Settings → Display: list of rules with add/edit/delete, toggle per rule, time picker
Requires SCHEDULE_EXACT_ALARM permission (already targeted API 31+); prompts user if not granted
Overnight schedules (e.g. sleep 23:00 → wake 07:00) handled by sorting rules chronologically and scheduling the next future alarm

Remote MQTT Commands¶

Accept inbound MQTT commands to control WebView navigation and state remotely from Home Assistant or any MQTT client.

New subscription topic: {clientId}/command/set; payload is a JSON object { "action": "...", "value": "..." }
Supported actions: navigate (load arbitrary URL), reload (refresh current page), back (WebView history back), forward, clear_cache, navigate_home (load configured home URL), evaluate_js (execute a JS snippet in the page)
ObserveMqttRemoteCommandUseCase filters the shared MQTT command flow and maps payloads to a RemoteCommand sealed class in domain-core
MainViewModel.observeRemoteCommands() collects the flow and translates each command to the appropriate MainIntent; WebView/GeckoView executes via existing webViewClient hooks
HA Discovery: button entity per action for reload and navigate_home; text entity for navigate URL input
All commands logged at DEBUG level via the existing analytics pipeline

Auto Reboot¶

Schedule automatic device reboots (e.g. 2 AM every two weeks) for long-running kiosk deployments.

AlarmManager + DevicePolicyManager.reboot() (requires device owner)
Configurable time and recurrence interval in Settings

MQTT TLS + DNS¶

Improve MQTT connectivity for production deployments.

Accept hostnames in addition to IP addresses for broker address
TLS support with configurable certificate (port 8883)

Front Light Color Temperature¶

Adjust the warmth/coolness of the display front light where hardware supports it.

Investigate NIGHT_DISPLAY_* / display color matrix APIs
Device-specific availability — expose only when supported

Light Sensor Dimming¶

Use the device's ambient light sensor as an alternative (or complement) to camera-based motion detection for screen brightness control.

Read TYPE_LIGHT sensor values
Map lux levels to configurable brightness thresholds
Can run independently of or alongside the existing CameraX motion detector
Useful for devices without a usable front camera

Acoustic Detection¶

Use the device's microphone to detect ambient sound as a presence signal — an alternative or complement to camera-based motion detection, useful for devices without a usable front camera (e.g. Android TV boxes).

Read raw audio amplitude via AudioRecord or MediaRecorder.getMaxAmplitude() at a configurable polling interval
Configurable sensitivity threshold (dB level) — above threshold fires the same MOTION_DETECTED event as CameraX
Runs inside MotionService as an optional detection mode; can operate alongside or independently of CameraX
Toggle in Settings → Motion section; disabled by default (requires microphone permission)
Publishes presence state via MQTT identically to camera-based detection
Particularly useful for Android TV deployments where USB webcam is absent but a USB mic or built-in mic is available

Done¶

Android TV Support ✓¶

Runs kite-aos on Android TV boxes as a 10-foot Home Assistant dashboard from a single codebase — a tv build flavor, not a fork. Full parity with the tablet build, including USB-webcam motion detection and MJPEG streaming. See the Android TV as-built reference for the complete design and implementation map.

New formfactor flavor dimension (mobile/tv) in the convention plugins; shares all domain-*/data-* modules unchanged, diverges only in presentation-* via src/tv/ source-sets
Runtime TV detection centralised in AppConfig (UI-mode / FEATURE_LEANBACK / BuildConfig.IS_TV); leanback launcher + banner so the app appears on the TV home screen
Hybrid 10-foot UI: FormFactor + WindowSizeClass drive Theme.is10Foot token up-scaling; D-pad focus rings via Modifier.tvFocusRing
D-pad control-drawer access via a hidden directional combo (no FAB, no PIN); TV settings use a single-focus-target master/detail list
USB-webcam motion: Camera2ExternalMotionSource → UVC (libausbc) fallback → MQTT presence fallback when no camera; MJPEG streaming reused from the webcam frames
device_class published via MQTT as tv; shared applicationId with a versionCode offset for Play multi-APK delivery

Screensaver ✓¶

Idle screensaver that activates after a configurable timeout, overlaid on the dimmed WebView.

Fullscreen slideshow from a local folder or Unsplash (configurable source)
Clock overlay (time + date)
Entity-status display: show live Home Assistant sensor values (temperature, humidity, etc.) via JS bridge from the already-loaded WebView session — no separate HA client needed
Configurable activation delay and transition interval
Dismisses on motion detection (integrates with existing CameraX pipeline)
MQTT command to force-activate / dismiss
MotionService emits ACTIVE | SCREENSAVER | LOCKED screen-state via a new use case; MainScreen renders the overlay in reaction to that state
Reused as the TV ambient mode (see Android TV); dismisses on MQTT motion or remote keypress

Camera Streaming (MJPEG) ✓¶

Expose the tablet's front camera as an MJPEG stream consumable by Home Assistant or any browser.

Embedded HTTP server (MjpegHttpServer) running inside MotionService foreground service
Two endpoints: /stream.mjpg (continuous multipart stream) and /snapshot.jpg (single frame)
Stream accessible on the local network (e.g. http://192.168.1.x:8080/stream.mjpg)
Configurable port, quality (0–100), and FPS in Settings
Toggle via Settings; camera rebinds to 640×480 when enabled, 176×144 when disabled
No data leaves the local network

Volume Control via MQTT ✓¶

Receive and publish device volume over MQTT.

Topic: {clientId}_volume/volume/set (inbound, 0–100)
Publishes confirmed volume state back to broker on change
Integrated with HA discovery

Screen Brightness via MQTT ✓¶

Control screen brightness remotely from Home Assistant or any MQTT client.

Topic: {clientId}_brightness/brightness/set (inbound, 0–255)
Publishes confirmed brightness state back to broker on change
Requires WRITE_SETTINGS permission (already declared)
Integrated with HA discovery via BrightnessConfigMqtt
Mirrors the volume MQTT implementation

Home Assistant Discovery ✓¶

Detect Home Assistant instances on the local network from the onboarding wizard.

mDNS hostname probes (homeassistant.local, etc.) with 900 ms timeout
Parallel subnet scan fallback
DiscoverHomeAssistantUseCase + HomeAssistantScannerImpl

Backup / Restore Configuration ✓¶

Export all app settings to a single JSON file and restore them on any device.

onExportConfig() in SettingsViewModel reads current state and serializes to JSON (kotlinx.serialization)
onImportConfigContent() parses the JSON and writes each preference back via existing use cases; onboarding state excluded
Export/Import UI in Settings — Android share sheet for export, SAF file picker for import
Config JSON includes a version field for forward-compatibility
Enables quick migration between tablets and multi-device deployments

Settings: Subtitle Hints ✓¶

Added descriptive subtitle/hint text below hard-to-understand settings to reduce support questions.

BaseListItem, ToggleListItem, NumberInputListItem, SimpleListItem, SectionToggleItem all support optional subtitle parameter
Hints added for: motion detector, sensitivity, dim delay, screen timeout, FAB delay, MQTT section, auto-return, WebView refresh

FAB Control via MQTT ✓¶

Show or hide the floating action button remotely from Home Assistant.

Subscribe to {clientId}_fab/fab/set inbound MQTT topic
ObserveMqttFabCommandUseCase filters the shared command flow, maps "ON" / "OFF" → Boolean
MainViewModel.observeFabCommand(): "ON" triggers onMotionDetected() (shows FAB + timer), "OFF" hides immediately
HA Discovery: switch entity with optimistic: true, icon mdi:gesture-tap-button

Low Motion / Reduce Animations ✓¶

Disables all Android animations globally for a smoother experience on slow kiosk hardware.

ReduceMotionPreference in Proto DataStore → full pipeline (serializer, source, repository, use cases)
Toggle in Settings → UX section, with subtitle hint
HostActivity applies ValueAnimator.setDurationScale(0f) via reflection (works API 26+) whenever the preference changes

Periodic WebView Refresh ✓¶

Automatically reload the dashboard at a configurable interval.

Toggle + interval (seconds) in Settings under a dedicated WebView Refresh section
Coroutine timer in MainViewModel — cancels/restarts on settings change
Auto-disables when interval is set to 0

UI Polish: Custom Controls & Loading State ✓¶

Replaced Material3 defaults with design system components; added shimmer loading experience.

All toggle controls use the custom Toggle component via ToggleListItem / SectionToggleItem — no Material3 Switch remains
ShimmerImage overlay displayed over the WebView while the page loads; debounced 400 ms to suppress auth-redirect flicker

Content¶

Demo Video¶

A short screen-recorded walkthrough of the main features: onboarding → dashboard → motion wake → control drawer → settings → MQTT in HA.