A Home Assistant custom integration extending the official SmartThings integration with Samsung WindFree AC capabilities.
Forked from the official homeassistant/components/smartthings integration
(HA 2025.6.x) and the now-unmaintained veista/custom integration.
disabledCapabilitiesfix: OverridesKEEP_CAPABILITY_QUIRKto always preserve WindFree AC capabilities (beep, display, power, air quality, dust) that Samsung marks as disabled on ARTIK051 devices. The official integration strips these capabilities because their attribute values areNone.- Quiet preset workaround: Forces "quiet" mode for ARTIK051 models that don't report it in supported modes
- Auto cleaning mode: Switch entity for
custom.autoCleaningMode - Dust filter reset: Button entity for
custom.dustFilter - Audio feedback volume: Select entity for
samsungce.airConditionerAudioFeedback
These capabilities have code in the official integration but don't work on
ARTIK051 WindFree ACs because Samsung lists them in disabledCapabilities:
- Display ON/OFF switch (
samsungce.airConditionerLighting) - Beep ON/OFF switch (
samsungce.airConditionerBeep) - Power consumption sensor (
powerConsumptionReport) - Air quality, dust, fine dust sensors
Our fork restores these by making KEEP_CAPABILITY_QUIRK unconditional for
WindFree AC capabilities.
- Remove veista/custom from HACS
- Delete the veista/custom config entry from HA
- Disable or delete ghost entities (unavailable sensors from old integration)
- Install this integration via HACS
- Set up SmartThings integration (OAuth2 flow)
- Add this repository as a custom repository in HACS
- Search for "SmartThings WindFree"
- Install
- Restart Home Assistant
- Copy
custom_components/smartthings/to your HA config directory - Restart Home Assistant
Same as official SmartThings integration: Settings → Devices & Services → Add Integration → SmartThings WindFree
Tested on Samsung WindFree ACs (model ARTIK051_PRAC_20K). Should work with other Samsung AC models that expose the relevant capabilities.