Verba Plugin profile

Voice PE Remote Timer

Start, cancel, or check the remaining time for a device-local Voice PE timer from one natural-language request.

voicepe_remote_timer Version 1.1.0
When to use

Best-fit scenarios

Use when the user wants to start a timer, cancel a timer, or ask how much time is left on a Voice PE timer.

How to call it

Execution guidance

Pass one natural-language timer request in query. Include the duration naturally for start requests. For status checks or cancel requests, no duration is needed.

Arguments

Input shape

  • query string

    ONE natural-language Voice PE timer request (for example: set a timer for 5 minutes, how much time is left, cancel the timer).

Settings

Required configuration

  • CANCEL_BUTTON_ENTITY string

    Explicit button entity to cancel timer, e.g. button.voicepe_office_remote_timer_cancel.

  • MAX_SECONDS number

    Clamp very large durations (default 2 hours).

    Default: 7200
  • REMAINING_SENSOR_ENTITY string

    Explicit sensor entity for remaining seconds, e.g. sensor.voicepe_office_remote_timer_remaining_seconds.

  • RUNNING_SENSOR_ENTITY string

    Explicit binary_sensor entity for running state, e.g. binary_sensor.voicepe_office_remote_timer_running.

  • START_BUTTON_ENTITY string

    Explicit button entity to start timer, e.g. button.voicepe_office_remote_timer_start.

  • TIMER_SECONDS_ENTITY string

    Explicit number entity for timer seconds, e.g. number.voicepe_office_remote_timer_seconds.

  • VOICEPE_ENTITY_PREFIX string

    Optional prefix used when inferring entities from the speaking device. Example: 'voicepe_office' would produce number.voicepe_office_remote_timer_seconds, etc. If blank, we will slugify context.device_name.

Example call

Canonical usage JSON

{
  "function": "voicepe_remote_timer",
  "arguments": {
    "query": "ONE natural-language Voice PE timer request (for example: set a timer for 5 minutes, how much time is left, cancel the timer)."
  }
}