# Govee

> Control your Govee lights, plugs and appliances: turn them on or off, set brightness, colour and scenes, and read sensors. Start a workflow when a device goes offline, is turned on or off, or a temperature or humidity reading crosses a level.

App · 18 actions. Web page: https://docs.lodol.com/docs/integrations/govee

## Actions

### Apply DIY scene

Play a DIY scene made for a light in the Govee Home app.

**Inputs**

- Device (`device_id`, text, required): The Govee device. Pick one, or give its ID from an earlier step.
- DIY scene (`diy_scene`, text, required): The DIY scene. Pick one, or type its name.

**Outputs**: What was sent to the device

- `device_id` (text): The device's ID
- `instance` (text): Govee's name for the setting changed, such as brightness
- `model` (text): Its model number (SKU)
- `name` (text): Its name in the Govee Home app
- `summary` (text): What was done, in words, such as Brightness 40%
- `value` (number): The value sent, as Govee takes it

**Example output**

```json
{
  "device_id": "9D:FA:85:EB:D3:00:8B:FF",
  "instance": "diyScene",
  "model": "H6159",
  "name": "Living room strip",
  "summary": "DIY scene Xmas",
  "value": 8216930
}
```

### Apply scene

Play one of a light's built-in scenes, such as Sunrise or Aurora.

**Inputs**

- Device (`device_id`, text, required): The Govee device. Pick one, or give its ID from an earlier step.
- Scene (`scene`, text, required): The scene. Pick one, or type its name.

**Outputs**: What was sent to the device

- `device_id` (text): The device's ID
- `instance` (text): Govee's name for the setting changed, such as brightness
- `model` (text): Its model number (SKU)
- `name` (text): Its name in the Govee Home app
- `summary` (text): What was done, in words, such as Brightness 40%
- `value` (number): The value sent, as Govee takes it

**Example output**

```json
{
  "device_id": "9D:FA:85:EB:D3:00:8B:FF",
  "instance": "lightScene",
  "model": "H6159",
  "name": "Living room strip",
  "summary": "Scene Sunrise",
  "value": {
    "id": 3853,
    "paramId": 4280
  }
}
```

### Apply snapshot

Put a light back to a snapshot saved in the Govee Home app.

**Inputs**

- Device (`device_id`, text, required): The Govee device. Pick one, or give its ID from an earlier step.
- Snapshot (`snapshot`, text, required): The snapshot. Pick one, or type its name.

**Outputs**: What was sent to the device

- `device_id` (text): The device's ID
- `instance` (text): Govee's name for the setting changed, such as brightness
- `model` (text): Its model number (SKU)
- `name` (text): Its name in the Govee Home app
- `summary` (text): What was done, in words, such as Brightness 40%
- `value` (number): The value sent, as Govee takes it

**Example output**

```json
{
  "device_id": "9D:FA:85:EB:D3:00:8B:FF",
  "instance": "snapshot",
  "model": "H6159",
  "name": "Living room strip",
  "summary": "Snapshot Movie night",
  "value": 1
}
```

### Get device state

Get what a device is doing now: whether it is online and on, its brightness and colour, and a sensor's temperature or humidity.

**Inputs**

- Device (`device_id`, text, required): The Govee device. Pick one, or give its ID from an earlier step.

**Outputs**: A device's state

- `brightness` (number): Brightness from 1 to 100
- `capabilities` (list): Govee's own list of values, each with its type, instance and state
- `co2` (number): Its carbon dioxide reading, in ppm
- `color` (text): Its colour as #RRGGBB
- `color_temperature` (number): Its colour temperature in Kelvin
- `device_id` (text): The device's ID
- `humidity` (number): Its humidity reading, in percent
- `model` (text): Its model number (SKU)
- `name` (text): Its name in the Govee Home app
- `online` (true/false): Whether it is connected. When false, the other values are from when it was last online
- `power` (text): on or off, or empty if it can't say
- `temperature` (number): Its temperature reading, in the unit Govee reports
- `values` (object): Every value it reports, by Govee's name for it (such as powerSwitch or nightlightToggle)

**Example output**

```json
{
  "brightness": 40,
  "capabilities": [
    {
      "instance": "online",
      "state": {
        "value": true
      },
      "type": "devices.capabilities.online"
    },
    {
      "instance": "powerSwitch",
      "state": {
        "value": 1
      },
      "type": "devices.capabilities.on_off"
    }
  ],
  "co2": null,
  "color": "#FF8800",
  "color_temperature": null,
  "device_id": "9D:FA:85:EB:D3:00:8B:FF",
  "humidity": null,
  "model": "H6159",
  "name": "Living room strip",
  "online": true,
  "power": "on",
  "temperature": null,
  "values": {
    "brightness": 40,
    "colorRgb": 16746496,
    "online": true,
    "powerSwitch": 1
  }
}
```

### List devices

List the devices in your Govee Home account, with each one's name, model and what it can do.

**Inputs**

- Type (`device_type`, text): Only devices of this type, such as lights or smart plugs. Leave blank for all. One of: `devices.types.light` (Lights), `devices.types.socket` (Smart plugs), `devices.types.sensor` (Sensors), `devices.types.thermometer` (Thermometers), `devices.types.air_quality_monitor` (Air quality monitors), `devices.types.air_purifier` (Air purifiers), `devices.types.heater` (Heaters), `devices.types.humidifier` (Humidifiers), `devices.types.dehumidifier` (Dehumidifiers), `devices.types.fan` (Fans), and 7 more.

**Outputs**

- `count` (number): How many
- `devices` (list): The devices

**Example output**

```json
{
  "count": 1,
  "devices": [
    {
      "capabilities": [
        {
          "instance": "powerSwitch",
          "parameters": {
            "dataType": "ENUM",
            "options": [
              {
                "name": "on",
                "value": 1
              },
              {
                "name": "off",
                "value": 0
              }
            ]
          },
          "type": "devices.capabilities.on_off"
        },
        {
          "instance": "brightness",
          "parameters": {
            "dataType": "INTEGER",
            "range": {
              "max": 100,
              "min": 1,
              "precision": 1
            },
            "unit": "unit.percent"
          },
          "type": "devices.capabilities.range"
        }
      ],
      "device_id": "9D:FA:85:EB:D3:00:8B:FF",
      "features": [
        "power",
        "brightness",
        "color",
        "color_temperature",
        "scene"
      ],
      "kind": "Lights",
      "model": "H6159",
      "name": "Living room strip",
      "toggles": [
        "gradientToggle"
      ],
      "type": "devices.types.light"
    }
  ]
}
```

### List scenes

List a light's scenes, the DIY scenes made for it in the Govee Home app, and its snapshots.

**Inputs**

- Device (`device_id`, text, required): The Govee device. Pick one, or give its ID from an earlier step.

**Outputs**

- `device_id` (text): The device's ID
- `diy_scenes` (list): Its DIY scenes
- `model` (text): Its model number (SKU)
- `name` (text): Its name
- `scenes` (list): Its scenes
- `snapshots` (list): Its snapshots

**Example output**

```json
{
  "device_id": "9D:FA:85:EB:D3:00:8B:FF",
  "diy_scenes": [
    {
      "name": "Xmas",
      "value": "8216930"
    }
  ],
  "model": "H6159",
  "name": "Living room strip",
  "scenes": [
    {
      "name": "Sunrise",
      "value": "{\"id\":3853,\"paramId\":4280}"
    }
  ],
  "snapshots": [
    {
      "name": "Movie night",
      "value": "1"
    }
  ]
}
```

### Set brightness

Set a light's brightness, from 1 (dimmest) to 100 (brightest).

**Inputs**

- Device (`device_id`, text, required): The Govee device. Pick one, or give its ID from an earlier step.
- Brightness (`brightness`, number, required): From 1 to 100, in percent. From 1 to 100.

**Outputs**: What was sent to the device

- `device_id` (text): The device's ID
- `instance` (text): Govee's name for the setting changed, such as brightness
- `model` (text): Its model number (SKU)
- `name` (text): Its name in the Govee Home app
- `summary` (text): What was done, in words, such as Brightness 40%
- `value` (number): The value sent, as Govee takes it

**Example output**

```json
{
  "device_id": "9D:FA:85:EB:D3:00:8B:FF",
  "instance": "brightness",
  "model": "H6159",
  "name": "Living room strip",
  "summary": "Brightness 40%",
  "value": 40
}
```

### Set colour

Set a light to one colour, such as #FF8800 or blue.

**Inputs**

- Device (`device_id`, text, required): The Govee device. Pick one, or give its ID from an earlier step.
- Colour (`color`, text, required): A colour as hex, such as #FF8800, as red,green,blue (255,136,0), or a name: white, red, orange, yellow, green, cyan, blue, purple or pink.

**Outputs**: What was sent to the device

- `device_id` (text): The device's ID
- `instance` (text): Govee's name for the setting changed, such as brightness
- `model` (text): Its model number (SKU)
- `name` (text): Its name in the Govee Home app
- `summary` (text): What was done, in words, such as Brightness 40%
- `value` (number): The value sent, as Govee takes it

**Example output**

```json
{
  "device_id": "9D:FA:85:EB:D3:00:8B:FF",
  "instance": "colorRgb",
  "model": "H6159",
  "name": "Living room strip",
  "summary": "Colour #FF8800",
  "value": 16746496
}
```

### Set colour temperature

Set a light to a shade of white, in Kelvin: lower is warmer, higher is cooler. Each light has its own range, often 2000 to 9000.

**Inputs**

- Device (`device_id`, text, required): The Govee device. Pick one, or give its ID from an earlier step.
- Colour temperature (K) (`kelvin`, number, required): In Kelvin, such as 2700 for warm white or 6500 for daylight. It must be within the light's range.

**Outputs**: What was sent to the device

- `device_id` (text): The device's ID
- `instance` (text): Govee's name for the setting changed, such as brightness
- `model` (text): Its model number (SKU)
- `name` (text): Its name in the Govee Home app
- `summary` (text): What was done, in words, such as Brightness 40%
- `value` (number): The value sent, as Govee takes it

**Example output**

```json
{
  "device_id": "9D:FA:85:EB:D3:00:8B:FF",
  "instance": "colorTemperatureK",
  "model": "H6159",
  "name": "Living room strip",
  "summary": "Colour temperature 2700 K",
  "value": 2700
}
```

### Set humidity, volume or another level

Set one of a device's levels other than brightness, such as a humidifier's target humidity, within the device's range.

**Inputs**

- Device (`device_id`, text, required): The Govee device. Pick one, or give its ID from an earlier step.
- Level (`level`, text, required): What to set, from those the device has.
- Value (`value`, number, required): A whole number within the range shown beside the level.

**Outputs**: What was sent to the device

- `device_id` (text): The device's ID
- `instance` (text): Govee's name for the setting changed, such as brightness
- `model` (text): Its model number (SKU)
- `name` (text): Its name in the Govee Home app
- `summary` (text): What was done, in words, such as Brightness 40%
- `value` (number): The value sent, as Govee takes it

**Example output**

```json
{
  "device_id": "9D:FA:85:EB:D3:00:8B:FF",
  "instance": "humidity",
  "model": "H6159",
  "name": "Living room strip",
  "summary": "Humidity 50",
  "value": 50
}
```

### Set mode

Choose one of a device's modes, such as a night light scene, an HDMI input or a diffuser's preset.

**Inputs**

- Device (`device_id`, text, required): The Govee device. Pick one, or give its ID from an earlier step.
- Mode (`mode`, text, required): The mode, from those the device has.

**Outputs**: What was sent to the device

- `device_id` (text): The device's ID
- `instance` (text): Govee's name for the setting changed, such as brightness
- `model` (text): Its model number (SKU)
- `name` (text): Its name in the Govee Home app
- `summary` (text): What was done, in words, such as Brightness 40%
- `value` (number): The value sent, as Govee takes it

**Example output**

```json
{
  "device_id": "9D:FA:85:EB:D3:00:8B:FF",
  "instance": "nightlightScene",
  "model": "H6159",
  "name": "Living room strip",
  "summary": "Night light scene: Ocean",
  "value": 2
}
```

### Set segment brightness

Dim or brighten some parts of a light strip, from 0 to 100.

**Inputs**

- Device (`device_id`, text, required): The Govee device. Pick one, or give its ID from an earlier step.
- Segments (`segments`, list, required): The parts of the strip to change. Govee numbers them from 0.
- Brightness (`brightness`, number, required): From 0 (off) to 100, in percent. From 0 to 100.

**Outputs**: What was sent to the device

- `device_id` (text): The device's ID
- `instance` (text): Govee's name for the setting changed, such as brightness
- `model` (text): Its model number (SKU)
- `name` (text): Its name in the Govee Home app
- `summary` (text): What was done, in words, such as Brightness 40%
- `value` (number): The value sent, as Govee takes it

**Example output**

```json
{
  "device_id": "9D:FA:85:EB:D3:00:8B:FF",
  "instance": "segmentedBrightness",
  "model": "H6159",
  "name": "Living room strip",
  "summary": "Segments 0, 1, 2 brightness 50%",
  "value": {
    "brightness": 50,
    "segment": [
      0,
      1,
      2
    ]
  }
}
```

### Set segment colour

Colour some parts of a light strip and leave the rest as they are.

**Inputs**

- Device (`device_id`, text, required): The Govee device. Pick one, or give its ID from an earlier step.
- Segments (`segments`, list, required): The parts of the strip to change. Govee numbers them from 0.
- Colour (`color`, text, required): A colour as hex, such as #FF8800, as red,green,blue (255,136,0), or a name: white, red, orange, yellow, green, cyan, blue, purple or pink.

**Outputs**: What was sent to the device

- `device_id` (text): The device's ID
- `instance` (text): Govee's name for the setting changed, such as brightness
- `model` (text): Its model number (SKU)
- `name` (text): Its name in the Govee Home app
- `summary` (text): What was done, in words, such as Brightness 40%
- `value` (number): The value sent, as Govee takes it

**Example output**

```json
{
  "device_id": "9D:FA:85:EB:D3:00:8B:FF",
  "instance": "segmentedColorRgb",
  "model": "H6159",
  "name": "Living room strip",
  "summary": "Segments 0, 1, 2 colour #0000FF",
  "value": {
    "rgb": 255,
    "segment": [
      0,
      1,
      2
    ]
  }
}
```

### Set target temperature

Set the temperature a heater, thermostat or kettle heats to.

**Inputs**

- Device (`device_id`, text, required): The Govee device. Pick one, or give its ID from an earlier step.
- Temperature (`temperature`, number, required): A whole number of degrees, within the device's range.
- Unit (`unit`, text): Celsius or Fahrenheit. Defaults to Celsius. One of: `Celsius` (Celsius (°C)), `Fahrenheit` (Fahrenheit (°F)). Default: `Celsius`.
- Stop when reached (`auto_stop`, true/false): Turn off once the temperature is reached, rather than keep it there. Only some devices offer this.

**Outputs**: What was sent to the device

- `device_id` (text): The device's ID
- `instance` (text): Govee's name for the setting changed, such as brightness
- `model` (text): Its model number (SKU)
- `name` (text): Its name in the Govee Home app
- `summary` (text): What was done, in words, such as Brightness 40%
- `value` (number): The value sent, as Govee takes it

**Example output**

```json
{
  "device_id": "9D:FA:85:EB:D3:00:8B:FF",
  "instance": "targetTemperature",
  "model": "H6159",
  "name": "Living room strip",
  "summary": "Target temperature 22\u00b0C",
  "value": {
    "temperature": 22,
    "unit": "Celsius"
  }
}
```

### Set work mode

Set how an appliance runs, such as a purifier's or humidifier's manual, auto or sleep mode and its speed.

**Inputs**

- Device (`device_id`, text, required): The Govee device. Pick one, or give its ID from an earlier step.
- Work mode (`work_mode`, text, required): The work mode, and its level where it has them.
- Level (`mode_value`, number): A level for the mode, as a number, when the mode takes one the list doesn't show. Leave blank otherwise.

**Outputs**: What was sent to the device

- `device_id` (text): The device's ID
- `instance` (text): Govee's name for the setting changed, such as brightness
- `model` (text): Its model number (SKU)
- `name` (text): Its name in the Govee Home app
- `summary` (text): What was done, in words, such as Brightness 40%
- `value` (number): The value sent, as Govee takes it

**Example output**

```json
{
  "device_id": "9D:FA:85:EB:D3:00:8B:FF",
  "instance": "workMode",
  "model": "H6159",
  "name": "Living room strip",
  "summary": "Work mode Gear mode: Medium",
  "value": {
    "modeValue": 2,
    "workMode": 1
  }
}
```

### Start music mode

Make a light react to sound from its microphone, in one of its music modes.

**Inputs**

- Device (`device_id`, text, required): The Govee device. Pick one, or give its ID from an earlier step.
- Music mode (`music_mode`, text, required): The music mode, such as Rhythm or Spectrum.
- Sensitivity (`sensitivity`, number): How strongly it reacts to sound, from 0 to 100. Defaults to 50. From 0 to 100. Default: `50`.
- Colour (`color`, text): A colour to use, such as #FF8800 or blue. Leave blank to let the light choose its own colours.

**Outputs**: What was sent to the device

- `device_id` (text): The device's ID
- `instance` (text): Govee's name for the setting changed, such as brightness
- `model` (text): Its model number (SKU)
- `name` (text): Its name in the Govee Home app
- `summary` (text): What was done, in words, such as Brightness 40%
- `value` (number): The value sent, as Govee takes it

**Example output**

```json
{
  "device_id": "9D:FA:85:EB:D3:00:8B:FF",
  "instance": "musicMode",
  "model": "H6159",
  "name": "Living room strip",
  "summary": "Music mode Rhythm",
  "value": {
    "autoColor": 1,
    "musicMode": 1,
    "sensitivity": 50
  }
}
```

### Turn a feature on or off

Turn one feature of a device on or off, such as a fan's oscillation, a humidifier's night light or a light's gradient.

**Inputs**

- Device (`device_id`, text, required): The Govee device. Pick one, or give its ID from an earlier step.
- Feature (`feature`, text, required): The feature, from those the device has.
- Turn (`turn`, text, required): On or off. One of: `on`, `off`.

**Outputs**: What was sent to the device

- `device_id` (text): The device's ID
- `instance` (text): Govee's name for the setting changed, such as brightness
- `model` (text): Its model number (SKU)
- `name` (text): Its name in the Govee Home app
- `summary` (text): What was done, in words, such as Brightness 40%
- `value` (number): The value sent, as Govee takes it

**Example output**

```json
{
  "device_id": "9D:FA:85:EB:D3:00:8B:FF",
  "instance": "oscillationToggle",
  "model": "H6159",
  "name": "Living room strip",
  "summary": "Oscillation on",
  "value": 1
}
```

### Turn on or off

Turn a light, plug or appliance on or off.

**Inputs**

- Device (`device_id`, text, required): The Govee device. Pick one, or give its ID from an earlier step.
- Turn (`power`, text, required): On or off. One of: `on`, `off`.

**Outputs**: What was sent to the device

- `device_id` (text): The device's ID
- `instance` (text): Govee's name for the setting changed, such as brightness
- `model` (text): Its model number (SKU)
- `name` (text): Its name in the Govee Home app
- `summary` (text): What was done, in words, such as Brightness 40%
- `value` (number): The value sent, as Govee takes it

**Example output**

```json
{
  "device_id": "9D:FA:85:EB:D3:00:8B:FF",
  "instance": "powerSwitch",
  "model": "H6159",
  "name": "Living room strip",
  "summary": "Turned on",
  "value": 1
}
```
