Verba profile

Voice PE Remote Timer

Start, cancel, or check a Voice PE (ESPHome) timer device.

voicepe_remote_timer Version 1.2.0
When to use

Best-fit scenarios

No description is present in the current Verba metadata.

How to call it

Execution guidance

Use the example call shape below and provide only the fields the plugin expects.

Arguments

Input shape

This Verba does not require named arguments in its published usage example. Hydra usually triggers it directly from the user's request or from recent conversation context.

Settings

Required configuration

This Verba does not declare plugin-specific settings in its metadata. Any dependencies are handled through portal config, environment variables, or the backing service itself.

Usage guide

How this plugin fits real-world workflows.

These notes focus on the setup, calling pattern, and runtime behavior that matter most for this plugin.

Voice PEESPHomeRequired firmware

Flash the right Voice PE firmware first

This plugin expects a Voice PE build that exposes the remote timer entities in Home Assistant.

  • Before using this plugin, flash your Voice PE with the Tater timer configuration so the expected timer entities exist in Home Assistant.
  • The plugin works against entity patterns such as number.voicepe_*_remote_timer_seconds, button.voicepe_*_remote_timer_start, button.voicepe_*_remote_timer_cancel, sensor.voicepe_*_remote_timer_remaining_seconds, and binary_sensor.voicepe_*_remote_timer_running.
  • If those entities do not exist yet, the plugin will not be able to infer or control the device timer correctly.
InferenceEntity IDsHome Assistant

Entity setup

You can let the plugin infer the device entities from context, or set them explicitly in Tater.

  • If your Voice PE entity IDs follow the normal naming pattern, the plugin can infer them from the speaking device name or an optional VOICEPE_ENTITY_PREFIX.
  • If your setup is custom, fill in TIMER_SECONDS_ENTITY, START_BUTTON_ENTITY, CANCEL_BUTTON_ENTITY, REMAINING_SENSOR_ENTITY, and RUNNING_SENSOR_ENTITY in plugin settings.
  • The plugin also respects MAX_SECONDS so unusually large timer requests can be clamped safely.
Example call

Canonical usage JSON

{
  "function": "voicepe_remote_timer",
  "arguments": {}
}