Skip to content

App and device modules

App

{
  "app": {
    "language": "en",
    "keep_screen_on": true,
    "screensaver": {
      "enabled": true,
      "idle_seconds": 300,
      "provider_id": "family-photos",
      "show_clock": true,
      "show_badges": true,
      "badges_position": "bottom",
      "badges_orientation": "horizontal"
    }
  }
}

language accepts de, en and fr; keep_screen_on has the alias always_on. The screensaver supports enabled, idle_seconds/timeout_seconds, provider_id/connection_id, show_clock/clock_enabled, show_badges/show_sensors, badges, badges_position, badges_orientation, badges_text_color, badges_outline_color and matching sensor_* aliases.

Local privacy locks

The Settings tab can hard-disable the camera and Voice Assist independently. These two switches are stored exclusively in the app’s private local storage, default to off and take precedence over profiles, device overrides and HA entities. Enabling a lock immediately stops active camera or microphone sessions, removes published camera URLs and rejects new camera or Assist commands. Home Assistant displays the local lock through diagnostic binary sensors and cannot enable a blocked function. Only a user directly at the Android device can remove the lock.

Voice Assistant

{
  "voice_assistant": {
    "enabled": true,
    "wake_word": true,
    "active_wake_words": ["okay_nabu"],
    "push_to_talk": true,
    "pipeline_id": "preferred",
    "audio_route": "speakerphone",
    "audio_source": "voice_recognition",
    "tts_output": "ha_stream",
    "follow_up_timeout": 15,
    "pipeline_timeout": 300,
    "processing_timeout": 120,
    "wake_word_timeout": 30,
    "noise_suppression_level": 0,
    "auto_gain_dbfs": 0,
    "status_sounds": true,
    "status_sound_volume": 70
  }
}

active_wake_words is set through the standard HA satellite configuration and contains IDs offered by the selected server-side wake-word engine. audio_route is system, speakerphone, earpiece or bluetooth; tts_output is ha_stream or Android TTS. bluetooth uses the bidirectional HFP/SCO profile of a device already paired in Android for Assist, including that device’s microphone. On Android 12 or newer, Nearby devices access must be granted locally once. Leave audio_route unchanged for an A2DP-only playback speaker; this setting applies only to Assist and bluetooth requires a microphone profile. push_to_talk_mode is hold or toggle. Local wake-word inference is not included.

Camera, media player and sensors

camera or cameras configures enabled, id, facing, resolution, max_width (320–1920), stream_fps (1–30), jpeg_quality (30–95), transport (direct or tunnel), port, base_path and optional local HTTPS access. stream_fps is adjustable per device through the HA number entity; the app requests the selected rate from the camera driver and HA relays the native MJPEG stream without snapshot throttling. The rate actually achieved depends on the camera, driver, resolution and JPEG quality. media_player.enabled defaults to false; further run-time settings use the HA entity. sensors may set enabled, interval_seconds and change_threshold per sensor type. GPS/location is unavailable.