Add HiVi Speaker integration documentation by swansmart · Pull Request #44021 · home-assistant/home-assistant.io

swansmart · 2026-03-11T02:09:41Z

This document provides detailed instructions on integrating HiVi Multi-Room speakers with Home Assistant, including setup, options, and troubleshooting.

Proposed change

Type of change

Spelling, grammar or other readability improvements (current branch).
Adjusted missing or incorrect information in the current documentation (current branch).
Added documentation for a new integration I'm adding to Home Assistant (next branch).
- I've opened up a PR to add logos and icons in Brands repository.
Added documentation for a new feature I'm adding to Home Assistant (next branch).
Removed stale or deprecated documentation.

Additional information

Link to parent pull request in the codebase: Add hivi speaker integration core#165307
Link to parent pull request in the Brands repository: Add icons for HiVi Speaker brands#9960
This PR fixes or closes issue:

Checklist

This PR uses the correct branch, based on one of the following:
- I made a change that is related to an upcoming version of Home Assistant and used the next branch.
The documentation follows the Home Assistant documentation standards.

This document provides detailed instructions on integrating HiVi Multi-Room speakers with Home Assistant, including setup, options, and troubleshooting.

home-assistant · 2026-03-11T02:09:45Z

It seems that this PR is targeted against an incorrect branch. Documentation updates which apply to our current stable release should target the current branch. Please change the target branch of this PR to current and rebase if needed. If this is documentation for a new feature, please add a link to that PR in your description.

netlify · 2026-03-11T02:09:47Z

❌ Deploy Preview for home-assistant-docs failed.

Name	Link
🔨 Latest commit	`e09e463`
🔍 Latest deploy log	https://app.netlify.com/projects/home-assistant-docs/deploys/69b1797864fdb70008c310f7

Copilot

Pull request overview

Adds a new integration documentation page for the HiVi Speaker integration, describing how to discover and control HiVi multi-room speakers in Home Assistant and how to manage synchronized playback groups.

Changes:

Added a new integration page with front matter metadata (release, platforms, domain, codeowners, etc.).
Documented setup via config flow, entity behavior (media player and switch), and multi-room grouping workflow.
Included supported devices, troubleshooting, debug logging, and removal guidance.

source/_integrations/hivi_speaker.markdown

swansmart · 2026-03-11T02:14:50Z

This is documentation for a new integration (HiVi Speaker), not an update to existing docs, so the target branch next is correct.

Updated formatting and wording for clarity and consistency.

c0ffeeca7 · 2026-03-11T05:05:43Z

This is documentation for a new integration (HiVi Speaker), not an update to existing docs, so the target branch next is correct.

The bot thinks it's for the current branch because there is no core PR mentioned in the PR template. Please add the link to the core PR.

source/_integrations/hivi_speaker.markdown

home-assistant · 2026-03-11T05:42:55Z

Please take a look at the requested changes, and use the Ready for review button when you are done, thanks 👍

Learn more about our pull request process.

c0ffeeca7 · 2026-03-11T05:43:35Z

I'm drafting this PR, as changes are needed.

Please undraft it once the changes have been implemented and the PR is ready for review again.

Updated terminology from 'master/slave' to 'leader/follower' for HiVi speaker integration.

c0ffeeca7

Tiny style tweaks

source/_integrations/hivi_speaker.markdown

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>

source/_integrations/hivi_speaker.markdown

Updated instructions for setting up HiVi speaker integration and added a reference for enabling debug logging.

source/_integrations/hivi_speaker.markdown

c0ffeeca7 · 2026-03-11T07:48:39Z

thank you for the fixes!

swansmart · 2026-03-11T07:52:05Z

Thank you.

source/_integrations/hivi_speaker.markdown

c0ffeeca7

Thank you, @swansmart 👍

source/_integrations/hivi_speaker.markdown

netlify · 2026-03-11T15:01:23Z

✅ Deploy Preview for home-assistant-docs ready!

Name	Link
🔨 Latest commit	`2001d19`
🔍 Latest deploy log	https://app.netlify.com/projects/home-assistant-docs/deploys/69d88e241aa575000838a21c
😎 Deploy Preview	https://deploy-preview-44021--home-assistant-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Add HiVi Speaker integration documentation

62c96fc

This document provides detailed instructions on integrating HiVi Multi-Room speakers with Home Assistant, including setup, options, and troubleshooting.

Copilot AI review requested due to automatic review settings March 11, 2026 02:09

home-assistant bot assigned swansmart Mar 11, 2026

home-assistant bot added in-progress This PR/Issue is currently being worked on needs-rebase The PR has been branched of the wrong base branch or targets an incorrect target branch next This PR goes into the next branch labels Mar 11, 2026

Copilot started reviewing on behalf of swansmart March 11, 2026 02:10 View session

Copilot AI reviewed Mar 11, 2026

View reviewed changes

Refactor HiVi speaker integration documentation

489c704

Updated formatting and wording for clarity and consistency.

swansmart mentioned this pull request Mar 11, 2026

Add icons for HiVi Speaker home-assistant/brands#9960

Open

10 tasks

home-assistant bot added the has-parent This PR has a parent PR in another repo label Mar 11, 2026

c0ffeeca7 added the new-integration This PR adds documentation for a new Home Assistant integration label Mar 11, 2026

c0ffeeca7 unassigned swansmart Mar 11, 2026

c0ffeeca7 reviewed Mar 11, 2026

View reviewed changes

source/_integrations/hivi_speaker.markdown Outdated Show resolved Hide resolved

remove quotes around release

b2fa875

c0ffeeca7 requested changes Mar 11, 2026

View reviewed changes

source/_integrations/hivi_speaker.markdown Outdated Show resolved Hide resolved

home-assistant bot marked this pull request as draft March 11, 2026 05:42

Change master/slave terminology to leader/follower

9192cb9

Updated terminology from 'master/slave' to 'leader/follower' for HiVi speaker integration.

swansmart mentioned this pull request Mar 11, 2026

Add hivi speaker integration home-assistant/core#165307

Open

21 tasks

home-assistant bot removed the needs-rebase The PR has been branched of the wrong base branch or targets an incorrect target branch label Mar 11, 2026

swansmart requested a review from c0ffeeca7 March 11, 2026 06:54

c0ffeeca7 requested changes Mar 11, 2026

View reviewed changes

swansmart and others added 2 commits March 11, 2026 15:14

Apply suggestions from code review

08ded2d

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>

remove quotes in release

3f10c45

c0ffeeca7 requested changes Mar 11, 2026

View reviewed changes

source/_integrations/hivi_speaker.markdown Outdated Show resolved Hide resolved

source/_integrations/hivi_speaker.markdown Outdated Show resolved Hide resolved

Enhance HiVi speaker setup instructions and logging info

54e7c20

Updated instructions for setting up HiVi speaker integration and added a reference for enabling debug logging.

swansmart requested a review from c0ffeeca7 March 11, 2026 07:45

c0ffeeca7 reviewed Mar 11, 2026

View reviewed changes

source/_integrations/hivi_speaker.markdown Outdated Show resolved Hide resolved

fix typo

a0950b0

c0ffeeca7 marked this pull request as ready for review March 11, 2026 07:49

home-assistant bot requested a review from c0ffeeca7 March 11, 2026 07:49

Merge branch 'next' into next

a2729b3

c0ffeeca7 reviewed Mar 11, 2026

View reviewed changes

source/_integrations/hivi_speaker.markdown Outdated Show resolved Hide resolved

fix quotes to fix build

985ba27

c0ffeeca7 previously approved these changes Mar 11, 2026

View reviewed changes

c0ffeeca7 added awaits-parent Awaits the merge of an parent PR and removed in-progress This PR/Issue is currently being worked on labels Mar 11, 2026

Merge branch 'next' into next

e09e463

c0ffeeca7 reviewed Mar 11, 2026

View reviewed changes

source/_integrations/hivi_speaker.markdown Outdated Show resolved Hide resolved

tweak, hoping to kick netlify

444d686

c0ffeeca7 dismissed their stale review via 444d686 March 11, 2026 15:01

Merge branch 'next' into next

2001d19

Uh oh!

Conversation

swansmart commented Mar 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Proposed change

Type of change

Additional information

Checklist

Uh oh!

home-assistant bot commented Mar 11, 2026

Uh oh!

netlify bot commented Mar 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

❌ Deploy Preview for home-assistant-docs failed.

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

swansmart commented Mar 11, 2026

Uh oh!

c0ffeeca7 commented Mar 11, 2026

Uh oh!

Uh oh!

Uh oh!

home-assistant bot commented Mar 11, 2026

Uh oh!

c0ffeeca7 commented Mar 11, 2026

Uh oh!

c0ffeeca7 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

c0ffeeca7 commented Mar 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

swansmart commented Mar 11, 2026

Uh oh!

Uh oh!

c0ffeeca7 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

netlify bot commented Mar 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for home-assistant-docs ready!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

swansmart commented Mar 11, 2026 •

edited

Loading

netlify bot commented Mar 11, 2026 •

edited

Loading

c0ffeeca7 commented Mar 11, 2026 •

edited

Loading

netlify bot commented Mar 11, 2026 •

edited

Loading