FanSync for Home Assistant (Marketplace integration)

Installs: 64 sharing analytics
GitHub stars: 14
Connection: Uses the vendor's cloud
Upkeep: Updated in the last 6 months
Version: 0.11.1, October 25, 2026
Category: Climate
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: fansync
Source: github.com/tjbaker/homeassistant-fansync
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

FanSync is a Marketplace integration that controls Fanimation FanSync ceiling fans and their lights through the vendor's cloud. It adds fan, light and switch entities, with on/off, speed, direction and preset modes for fans, plus brightness and color temperature on tunable-white lights. A Home Away switch mirrors the Fanimation app's mode on fans that report it, and a Light installed switch removes a non-functional light entity on fans without a light kit. State changes arrive by cloud push, with a configurable fallback poll that can be turned off. Options also cover HTTP and WebSocket timeouts and a per-fan choice to hide the light of fans that have none. Setup happens in the UI with the email and password of a Fanimation FanSync account, and the integration prompts for a new password if the credentials expire.

Automatic summary of the README and code of tjbaker/homeassistant-fansync. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Uses the vendor's cloud Needs an internet connection and an account with the vendor.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Lights
Fans
Switches

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

FanSync Setup

Email
Password
Verify SSL certificate
HTTP timeout (seconds)
WebSocket timeout (seconds)

Re-authenticate FanSync

Password

After setup

Fallback poll interval (seconds, 0 to disable)
HTTP timeout (seconds)
WebSocket timeout (seconds)
Fans with no light (hide their Light entity)Select any fans that have no physical light. Some models report a light channel they don't actually have, creating a non-functional Light entity — checking a fan here hides its Light. Changing this reloads the integration.

Texts from the code of tjbaker/homeassistant-fansync.

Entities

FansFan
LightsLight
SwitchesLight installed, Home Away

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.

From the README

Custom Home Assistant integration for Fanimation FanSync devices with cloud push updates, automatic reauthentication, and multi-language support.
🏆 Quality: Bronze & Silver tier compliant 🌍 Languages: English, French (Français), Spanish (Español) 🔄 Updates: Real-time cloud push with fallback polling
Fan: On/off, speed, direction, preset modes (normal, fresh_air). Direction is hidden on fans the app marks as not reversible.
Light: On/off, brightness, and color temperature on tunable-white fixtures (fixed-temperature lights stay brightness-only).
Home Away switch: the Fanimation app's Home Away mode, on fans that report it. Turning it on stops the fan; turning the fan on again ends the mode.
Light installed switch on each fan's device page: turn it off on a fan with no light kit to remove its phantom Light entity.
Real-time Updates: Cloud push updates for instant state synchronization
Fallback Polling: Configurable polling when push unavailable (default: 60s)

From the README of tjbaker/homeassistant-fansync, Apache License 2.0. Shortened.