algrym/govee-ble-h617a

Analysis updated 2026-05-18

★ 2PythonAudience · generalComplexity · 3/5LicenseSetup · moderate

Mindmap

mindmap
  root((Govee BLE H617A))
    What it does
      Control Govee strips
      BLE direct control
      Scene animations
      Speed control
    H617A Fixes
      Activate command
      BLE transport hardening
      Scene speed rewrite
    Setup
      HACS custom repo
      Bluetooth required
      Auto-discovery
    Audience
      Home Assistant users
      Smart home builders

mindmap root((Govee BLE H617A)) What it does Control Govee strips BLE direct control Scene animations Speed control H617A Fixes Activate command BLE transport hardening Scene speed rewrite Setup HACS custom repo Bluetooth required Auto-discovery Audience Home Assistant users Smart home builders

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

Control Govee H617A LED strips from Home Assistant, including on/off, color, brightness, and animated scene selection.

USE CASE 2

Use animated lighting scenes on an H617A strip from the Home Assistant effect dropdown without needing the Govee app.

USE CASE 3

Adjust scene animation speed from Home Assistant and save per-scene speed presets that survive restarts.

USE CASE 4

Connect Govee strips through an ESPHome BLE proxy with reliable write acknowledgment instead of silent packet drops.

What is it built with?

PythonHome AssistantBluetooth BLEHACSESPHome

How does it compare?

	algrym/govee-ble-h617a	0-bingwu-0/live-interpreter	0xkaz/llm-governance-dashboard
Stars	2	2	2
Language	Python	Python	Python
Setup difficulty	moderate	moderate	hard
Complexity	3/5	2/5	4/5
Audience	general	general	ops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Home Assistant with Bluetooth access on the host machine and the Govee strip within BLE range.

Free to use, modify, and redistribute for any purpose including commercial use, as long as you include the copyright notice.

In plain English

This repository is a custom Home Assistant integration for controlling Govee LED lighting strips over Bluetooth (BLE). It is a fork of an existing integration that has been extended to add working scene animations and speed control for the Govee H617A RGBIC strip, which the original did not support correctly. When you connect a Govee strip through this integration, you can turn it on or off, change its color, adjust brightness, and select from the light's built-in animated scenes (such as fireworks or ocean waves) directly from the Home Assistant interface. The integration handles the Bluetooth communication itself, so no separate Govee app or cloud account is needed for local control. The core addition in this fork is fixing how scenes work on the H617A model. The original integration would upload a scene's data to the strip but the animation would never start, because the strip requires a separate "activate" command sent after loading a scene. The author reverse-engineered this command directly from H617A hardware and added it. The fork also hardens the Bluetooth transport so that failed writes are detected and retried rather than silently dropped, which matters especially when the strip is connected through an ESPHome Bluetooth proxy rather than a direct connection. Scene speed is also controllable from Home Assistant. Rather than a simple speed number, the integration rewrites the timing data inside the scene's own payload to match speed levels defined in the strip's scene catalog. Speed can be set globally per strip or saved as a per-scene preset that persists across Home Assistant restarts. Installation is through HACS (Home Assistant Community Store) by adding this fork as a custom repository. Once installed and Home Assistant is restarted, compatible Govee strips in Bluetooth range are discovered automatically. The code is released under the MIT license.

Copy-paste prompts

Prompt 1

How do I add the algrym/govee-ble-h617a fork as a custom HACS repository in Home Assistant and install it?

Prompt 2

My Govee H617A shows scene names in Home Assistant but the animation never starts. How does this fork fix that with an activate packet?

Prompt 3

Show me how to use the govee-ble-lights.set_speed and set_scene_speed services in a Home Assistant automation to set calm lighting at night.

Prompt 4

How do I create a Home Assistant automation that switches my H617A to a specific scene at sunset with a custom speed level?

Frequently asked questions

What is govee-ble-h617a?

A Home Assistant integration for controlling Govee LED strips over Bluetooth, with fixed scene animations and speed control specifically for the H617A model.

What language is govee-ble-h617a written in?

Mainly Python. The stack also includes Python, Home Assistant, Bluetooth BLE.

What license does govee-ble-h617a use?

Free to use, modify, and redistribute for any purpose including commercial use, as long as you include the copyright notice.

How hard is govee-ble-h617a to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is govee-ble-h617a for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub algrym on gitmyhub

Verify against the repo before relying on details.