# ha-hunterbtt

Extremely vibe-coded Hunter BTT integration for Home Assistant.

Experimental. Minimal testing performed with a BTT-101, firwmare 5.0.1.4.

To install, place `custom_components/hunter_btt` in your HA
`config/custom_components` directory.

# behavior

BTTs are battery powered Bluetooth devices. To save power, the integration only
polls once per day while the valve is closed, and once every 30 minutes while
the valve is open.

The firmware requires a duration to be specified when opening the valve. This
is the 'manual duration' control, which should be set to the correct value
before opening the valve. (Or, if you intend to stop it manually, simply set it
to some long sentinel value. Just know that that is your fallback in case of
issues.)

```yaml
actions:
  - action: number.set_value
    target:
      entity_id: number.hunter_btt_manual_duration
    data:
      value: 30
  - action: valve.open_valve
    target:
      entity_id: valve.hunter_btt_valve
```

# development

```
uv run ruff format
uv run ruff check
uv run mypy
uv run pytest
```
