feat: Add DreamView (Movie Mode) toggle support

Add switch entity for devices with dreamViewToggle capability,
such as Govee Immersion TV backlights. Uses the standard toggle
API pattern with devices.capabilities.toggle type.

Closes #6

Author: Tom Lasswell

custom_components/govee/manifest.json

@@ -16,6 +16,6 @@
     "cryptography>=41.0.0"
   ],
   "ssdp": [],
-  "version": "2026.1.54",
+  "version": "2026.1.55",
   "zeroconf": []
 }

custom_components/govee/models/__init__.py

@@ -17,6 +17,7 @@
     SegmentColorCommand,
     ToggleCommand,
     WorkModeCommand,
+    create_dreamview_command,
     create_night_light_command,
 )
 from .device import (
@@ -51,5 +52,6 @@
     "WorkModeCommand",
     "ModeCommand",
     "MusicModeCommand",
+    "create_dreamview_command",
     "create_night_light_command",
 ]

custom_components/govee/models/commands.py

@@ -24,6 +24,7 @@
     INSTANCE_COLOR_RGB,
     INSTANCE_COLOR_TEMP,
     INSTANCE_DIY,
+    INSTANCE_DREAMVIEW,
     INSTANCE_MUSIC_MODE,
     INSTANCE_NIGHT_LIGHT,
     INSTANCE_OSCILLATION,
@@ -233,6 +234,11 @@ def create_night_light_command(enabled: bool) -> ToggleCommand:
     return ToggleCommand(toggle_instance=INSTANCE_NIGHT_LIGHT, enabled=enabled)
 
 
+def create_dreamview_command(enabled: bool) -> ToggleCommand:
+    """Create a command to toggle DreamView (Movie Mode)."""
+    return ToggleCommand(toggle_instance=INSTANCE_DREAMVIEW, enabled=enabled)
+
+
 @dataclass(frozen=True)
 class OscillationCommand(DeviceCommand):
     """Command to toggle fan oscillation."""

custom_components/govee/models/device.py

@@ -45,6 +45,7 @@
 INSTANCE_WORK_MODE = "workMode"
 INSTANCE_HDMI_SOURCE = "hdmiSource"
 INSTANCE_MUSIC_MODE = "musicMode"
+INSTANCE_DREAMVIEW = "dreamViewToggle"
 
 
 @dataclass(frozen=True)
@@ -193,6 +194,11 @@ def is_oscillation(self) -> bool:
         """Check if this is an oscillation toggle (for fans)."""
         return self.type == CAPABILITY_TOGGLE and self.instance == INSTANCE_OSCILLATION
 
+    @property
+    def is_dreamview(self) -> bool:
+        """Check if this is a DreamView toggle (Movie Mode)."""
+        return self.type == CAPABILITY_TOGGLE and self.instance == INSTANCE_DREAMVIEW
+
     @property
     def is_work_mode(self) -> bool:
         """Check if this is a work mode capability (for fans)."""
@@ -294,6 +300,11 @@ def supports_oscillation(self) -> bool:
         """Check if device supports oscillation (fans)."""
         return any(cap.is_oscillation for cap in self.capabilities)
 
+    @property
+    def supports_dreamview(self) -> bool:
+        """Check if device supports DreamView (Movie Mode) toggle."""
+        return any(cap.is_dreamview for cap in self.capabilities)
+
     @property
     def supports_work_mode(self) -> bool:
         """Check if device supports work mode (fans)."""

custom_components/govee/strings.json

@@ -109,6 +109,9 @@
       },
       "govee_music_mode": {
         "name": "Music Mode"
+      },
+      "govee_dreamview": {
+        "name": "DreamView"
       }
     },
     "sensor": {

custom_components/govee/switch.py

@@ -17,7 +17,7 @@
 
 from .coordinator import GoveeCoordinator
 from .entity import GoveeEntity
-from .models import GoveeDevice, MusicModeCommand, PowerCommand, create_night_light_command
+from .models import GoveeDevice, MusicModeCommand, PowerCommand, create_dreamview_command, create_night_light_command
 
 _LOGGER = logging.getLogger(__name__)
 
@@ -53,6 +53,11 @@ async def async_setup_entry(
             entities.append(GoveeMusicModeSwitchEntity(coordinator, device, use_rest_api=False))
             _LOGGER.debug("Created BLE music mode switch entity for %s", device.name)
 
+        # Create switch for DreamView (Movie Mode) toggle
+        if device.supports_dreamview:
+            entities.append(GoveeDreamViewSwitchEntity(coordinator, device))
+            _LOGGER.debug("Created DreamView switch entity for %s", device.name)
+
     async_add_entities(entities)
     _LOGGER.debug("Set up %d Govee switch entities", len(entities))
 
@@ -283,3 +288,56 @@ async def async_turn_off(self, **kwargs: Any) -> None:
             if success:
                 self._is_on = False
                 self.async_write_ha_state()
+
+
+class GoveeDreamViewSwitchEntity(GoveeEntity, SwitchEntity):
+    """Govee DreamView (Movie Mode) toggle switch entity.
+
+    Controls DreamView mode for devices that support it (e.g., Immersion TV backlights).
+    Uses optimistic state since API may not return DreamView status.
+    """
+
+    _attr_translation_key = "govee_dreamview"
+    _attr_icon = "mdi:movie-open"
+
+    def __init__(
+        self,
+        coordinator: GoveeCoordinator,
+        device: GoveeDevice,
+    ) -> None:
+        """Initialize the DreamView switch entity."""
+        super().__init__(coordinator, device)
+
+        # Unique ID for DreamView switch
+        self._attr_unique_id = f"{device.device_id}_dreamview"
+
+        # Name as "DreamView"
+        self._attr_name = "DreamView"
+
+        # Optimistic state
+        self._is_on = False
+
+    @property
+    def is_on(self) -> bool:
+        """Return True if DreamView is on."""
+        return self._is_on
+
+    async def async_turn_on(self, **kwargs: Any) -> None:
+        """Turn DreamView on."""
+        success = await self.coordinator.async_control_device(
+            self._device_id,
+            create_dreamview_command(enabled=True),
+        )
+        if success:
+            self._is_on = True
+            self.async_write_ha_state()
+
+    async def async_turn_off(self, **kwargs: Any) -> None:
+        """Turn DreamView off."""
+        success = await self.coordinator.async_control_device(
+            self._device_id,
+            create_dreamview_command(enabled=False),
+        )
+        if success:
+            self._is_on = False
+            self.async_write_ha_state()

custom_components/govee/translations/en.json

@@ -109,6 +109,9 @@
       },
       "govee_music_mode": {
         "name": "Music Mode"
+      },
+      "govee_dreamview": {
+        "name": "DreamView"
       }
     },
     "sensor": {

tests/conftest.py

@@ -30,6 +30,7 @@
     INSTANCE_BRIGHTNESS,
     INSTANCE_COLOR_RGB,
     INSTANCE_COLOR_TEMP,
+    INSTANCE_DREAMVIEW,
     INSTANCE_HDMI_SOURCE,
     INSTANCE_OSCILLATION,
     INSTANCE_POWER,
@@ -516,3 +517,41 @@ def api_hdmi_state_response() -> dict[str, Any]:
             },
         ],
     }
+
+
+@pytest.fixture
+def dreamview_capabilities() -> tuple[GoveeCapability, ...]:
+    """Create capabilities for a DreamView-enabled device (e.g., H6199 Immersion)."""
+    return (
+        GoveeCapability(
+            type=CAPABILITY_ON_OFF,
+            instance=INSTANCE_POWER,
+            parameters={},
+        ),
+        GoveeCapability(
+            type=CAPABILITY_RANGE,
+            instance=INSTANCE_BRIGHTNESS,
+            parameters={"range": {"min": 0, "max": 100}},
+        ),
+        GoveeCapability(
+            type=CAPABILITY_TOGGLE,
+            instance=INSTANCE_DREAMVIEW,
+            parameters={
+                "dataType": "ENUM",
+                "options": [{"name": "on", "value": 1}, {"name": "off", "value": 0}],
+            },
+        ),
+    )
+
+
+@pytest.fixture
+def mock_dreamview_device(dreamview_capabilities) -> GoveeDevice:
+    """Create a mock DreamView-enabled device (e.g., H6199 Immersion)."""
+    return GoveeDevice(
+        device_id="AA:BB:CC:DD:EE:FF:00:66",
+        sku="H6199",
+        name="TV Backlight Immersion",
+        device_type=DEVICE_TYPE_LIGHT,
+        capabilities=dreamview_capabilities,
+        is_group=False,
+    )

tests/test_models.py

@@ -18,6 +18,7 @@
     OscillationCommand,
     WorkModeCommand,
     ModeCommand,
+    create_dreamview_command,
 )
 from custom_components.govee.models.device import (
     CAPABILITY_ON_OFF,
@@ -35,6 +36,7 @@
     INSTANCE_OSCILLATION,
     INSTANCE_WORK_MODE,
     INSTANCE_HDMI_SOURCE,
+    INSTANCE_DREAMVIEW,
 )
 
 
@@ -158,6 +160,21 @@ def test_is_hdmi_source(self):
         assert cap.is_hdmi_source is True
         assert cap.is_work_mode is False
 
+    def test_is_dreamview(self):
+        """Test DreamView toggle capability detection."""
+        cap = GoveeCapability(
+            type=CAPABILITY_TOGGLE,
+            instance=INSTANCE_DREAMVIEW,
+            parameters={
+                "dataType": "ENUM",
+                "options": [{"name": "on", "value": 1}, {"name": "off", "value": 0}],
+            },
+        )
+        assert cap.is_dreamview is True
+        assert cap.is_toggle is True
+        assert cap.is_night_light is False
+        assert cap.is_oscillation is False
+
     def test_immutable(self):
         """Test that GoveeCapability is immutable (frozen)."""
         cap = GoveeCapability(type=CAPABILITY_ON_OFF, instance=INSTANCE_POWER, parameters={})
@@ -257,6 +274,14 @@ def test_get_hdmi_source_options_no_support(self, mock_light_device):
         options = mock_light_device.get_hdmi_source_options()
         assert options == []
 
+    def test_supports_dreamview(self, mock_dreamview_device):
+        """Test DreamView support detection."""
+        assert mock_dreamview_device.supports_dreamview is True
+
+    def test_no_dreamview_support(self, mock_light_device):
+        """Test that regular lights don't have DreamView support."""
+        assert mock_light_device.supports_dreamview is False
+
     def test_from_api_response(self, api_device_response):
         """Test creating device from API response."""
         device = GoveeDevice.from_api_response(api_device_response)
@@ -541,3 +566,22 @@ def test_mode_command_immutable(self):
         cmd = ModeCommand(mode_instance="hdmiSource", value=1)
         with pytest.raises(AttributeError):
             cmd.value = 2
+
+    def test_dreamview_command_on(self):
+        """Test create_dreamview_command for turning DreamView on."""
+        cmd = create_dreamview_command(enabled=True)
+        assert cmd.toggle_instance == "dreamViewToggle"
+        assert cmd.enabled is True
+        assert cmd.get_value() == 1
+        payload = cmd.to_api_payload()
+        assert payload["type"] == "devices.capabilities.toggle"
+        assert payload["instance"] == "dreamViewToggle"
+        assert payload["value"] == 1
+
+    def test_dreamview_command_off(self):
+        """Test create_dreamview_command for turning DreamView off."""
+        cmd = create_dreamview_command(enabled=False)
+        assert cmd.enabled is False
+        assert cmd.get_value() == 0
+        payload = cmd.to_api_payload()
+        assert payload["value"] == 0