initial

Author: iluvdata

README.md

@@ -0,0 +1,44 @@
+# Google Nest Fan 
+
+
+[![hacs_badge](https://img.shields.io/badge/HACS-Custom-orange.svg?style=flat-square&logo=homeassistantcommunitystore)](https://hacs.xyz/)
+![GitHub Release](https://img.shields.io/github/v/release/iluvdata/google_nest_fan)
+![Dynamic JSON Badge](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Filuvdata%2Fgoogle_nest_fan%2Frefs%2Ftags%2F2025.7.1%2Fcustom_components%2Ftplink_cloud%2Fmanifest.json&query=%24.version&prefix=v&label=dev-version)
+
+
+A custom HomeAssistant integration that creates two additional entities for each Google Device with a Fan "trait" such as a Nest Thermostat.  These entities will allow you to set the fan to run for a customized amount of time (rather than the 12 hours hard coded into the core [Google Nest](https://www.home-assistant.io/integrations/nest/) integration.  The core Google Nest Integration must be configured and working for this integration to work.
+
+## Installation with HACS
+
+The recommended way to install this is via HACS:
+
+
+
+[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?category=custom_respository&owner=iluvdata&repository=google_nest_fan)
+
+#### Semi-manual install
+
+1. Click on HACS in the Homeassistant side bar
+2. Click on the three dots in the upper right-hand corner and select "Custom repositories."
+3. In the form enter:
+
+    1. Respository: `iluvdata/google_nest_fan`
+    2. Select "Integration" as "Type"
+
+## Manual Installation
+
+Copy the `google_nest_fan` directory to the `custom_components` directory of your Homeassistant Instance.
+
+## Configuration
+
+
+Add the intergration to Home Assistant:
+
+[![Open your Home Assistant instance and start setting up a new integration.](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=google_nest_fan)
+
+If the core **Google Nest** integration is configured this integration should be able to discover your devices with fan and add the additional controls.
+
+## Use
+
+Simple use the slider to select the amount of time you want to run the fan.  Upon changing the slider, it should send the request to the device to start the fan for the given duration.  To stop the fan, simply turn off through the core integration.   If you update the slider, it should change the duration to the most recent selected value.
+

custom_components/google_nest_fan/__init__.py

@@ -0,0 +1,54 @@
+"""Setup Google Nest Fan Integration."""
+
+from dataclasses import dataclass
+
+from google_nest_sdm.device import Device
+
+# pylint: disable=hass-component-root-import
+from homeassistant.components.nest.climate import ThermostatHvacTrait
+from homeassistant.components.nest.const import DOMAIN as NEST_DOMAIN
+from homeassistant.components.nest.types import NestConfigEntry
+
+# pylint: enable=hass-component-root-import
+from homeassistant.config_entries import ConfigEntry
+from homeassistant.core import HomeAssistant
+from homeassistant.exceptions import ConfigEntryError
+
+from .const import DOMAIN, PLATFORMS
+
+
+@dataclass
+class GoogleNestFanData:
+    """Class to hold integration data."""
+
+    devices: list[Device]
+
+
+type GoogleNestFan = ConfigEntry[GoogleNestFanData]
+
+
+async def async_setup_entry(hass: HomeAssistant, entry: GoogleNestFan) -> bool:
+    """Setup this config."""
+    entries: list[NestConfigEntry] = hass.config_entries.async_loaded_entries(
+        NEST_DOMAIN
+    )
+    if not entries:
+        raise ConfigEntryError(
+            translation_domain=DOMAIN, translation_key="nest_not_loaded"
+        )
+    devices: list[Device] = []
+    for nestentry in entries:
+        devices.extend(
+            device
+            for device in nestentry.runtime_data.device_manager.devices.values()
+            if ThermostatHvacTrait.NAME in device.traits
+        )
+    if not devices:
+        raise ConfigEntryError(
+            translation_domain=DOMAIN, translation_key="no_thermostats"
+        )
+    entry.runtime_data = GoogleNestFanData(devices)
+
+    await hass.config_entries.async_forward_entry_setups(entry, PLATFORMS)
+
+    return True

custom_components/google_nest_fan/__pycache__/__init__.cpython-313.pyc

@@ -0,0 +1,52 @@
+"""Config flow for the TPLink Cloud integration."""
+
+from __future__ import annotations
+
+import logging
+from typing import Any
+
+from google_nest_sdm.device import Device
+
+# pylint: disable=hass-component-root-import
+from homeassistant.components.nest.climate import ThermostatHvacTrait
+from homeassistant.components.nest.const import DOMAIN as NEST_DOMAIN
+from homeassistant.components.nest.types import NestConfigEntry
+
+# pylint: enable=hass-component-root-import
+from homeassistant.config_entries import ConfigFlow, ConfigFlowResult
+
+from .const import DOMAIN
+
+_LOGGER = logging.getLogger(__name__)
+
+
+class GoogleNestFanFlow(ConfigFlow, domain=DOMAIN):
+    """Google Nest Fan Flow."""
+
+    async def async_step_user(
+        self, user_input: dict[str, Any] | None = None
+    ) -> ConfigFlowResult:
+        """Add the integration."""
+        error: str = ""
+        entries: list[NestConfigEntry] = self.hass.config_entries.async_loaded_entries(
+            NEST_DOMAIN
+        )
+        if not entries:
+            error = "nest_not_loaded"
+        else:
+            devices: list[Device] = []
+            for entry in entries:
+                devices.extend(
+                    device
+                    for device in entry.runtime_data.device_manager.devices.values()
+                    if ThermostatHvacTrait.NAME in device.traits
+                )
+            if not devices:
+                error = "no_thermostats"
+        if not error:
+            return self.async_create_entry(
+                title="Google Nest Fan Customization",
+                description="Will create entries for all Nest fans",
+                data={},
+            )
+        return self.async_abort(reason=error)

custom_components/google_nest_fan/__pycache__/config_flow.cpython-313.pyc

@@ -0,0 +1,6 @@
+"""Google Nest Fan Constants."""
+
+from homeassistant.const import Platform
+
+DOMAIN = "google_nest_fan"
+PLATFORMS = {Platform.NUMBER, Platform.SENSOR}

custom_components/google_nest_fan/__pycache__/const.cpython-313.pyc

@@ -0,0 +1,18 @@
+{
+  "domain": "google_nest_fan",
+  "name": "Google Nest Fan Customization",
+  "codeowners": ["@iluvdata"],
+  "config_flow": true,
+  "single_config_entry": true,
+  "dependencies": ["nest"],
+  "documentation": "https://github.com/iluvdata/google_nest_fan",
+  "homekit": {},
+  "iot_class": "cloud_push",
+  "quality_scale": "bronze",
+  "requirements": [],
+  "ssdp": [],
+  "zeroconf": [],
+  "version": "2025.8.1",
+  "integration_type": "service",
+  "issue_tracker": "https://github.com/iluvdata/google_nest_fan/issues"
+}