Using a Quirk in my HA

[Hebichel]

I am new to HA. Pls tell me how to install a Quirk in HA. TIA

[mmonlouis]

Hello
Look this link
https://community.home-assistant.io/t/how-to-setup-local-zha-quirks/341226

[Hebichel]

Thanks !

[Hedda]

See basic instructions in this pull request:

• Add a how-to guide for how end-users can use a custom quirk in ZHA #2419

  • https://github.com/zigpy/zha-device-handlers/blob/a7c00899fda760289b840379b9b9fa654e6e16ee/README.md#how-end-users-can-test-a-not-yet-merged-custom-quirk-in-zha

Also check out more detailed instructions in this community guide here (which has more information as well):

• https://community.home-assistant.io/t/zigbee-guide-how-to-add-setup-local-custom-zha-device-handlers-also-known-as-quirks-in-the-zha-integration/683473/

[Hebichel]

Thanks !

[TheJulianJES]

Do note that all quirks in this repository are included in the newest/upcoming Home Assistant versions by default.

You should only ever install custom quirks (e.g. posted in issue comments) for testing until a PR is created and merged for them.

[TomF79]

Do note that all quirks in this repository are included in the newest/upcoming Home Assistant versions by default.

You should only ever install custom quirks (e.g. posted in issue comments) for testing until a PR is created and merged for them.

@TheJulianJES

I have a question about this. Now i have the file from #4052 in my costum quirk folder in HA and it works fine.

Is this included in the next upcoming HA Core Update 2025.5.2 or how can i check that this is included? After the update i have to delete the file in the custom folder

[TheJulianJES]

#4052 is a PR that's not merged yet. The quirk isn't in the repo, so it's also not part of HA.

It'll only be in HA after it's merged, then a new zha-quirks version needs to be released, it needs to be bumped in the ZHA lib, and finally the ZHA lib needs to be released and bumped in HA.
If the quirk gets merged in the next few weeks, it'll likely in 2025.6.0, although critical bug fixes may also land in patch versions (so HA version other than .0 releases).

[TheJulianJES]

You can keep using it as a custom quirk for now.
Custom quirks take priority over built-in quirks though, so you'd want to eventually delete it. But it's generally not a major issue if you don't immediately delete it, even if the HA version already has the quirk included (or a newer version of it). You'll just be using the (potentially older) custom quirk until it's deleted.

[TomF79]

It'll only be in HA after it's merged, then a new zha-quirks version needs to be released, it needs to be bumped in the ZHA lib, and finally the ZHA lib needs to be released and bumped in HA. If the quirk gets merged in the next few weeks, it'll likely in 2025.6.0, although critical bug fixes may also land in patch versions (so HA version other than .0 releases).

You can keep using it as a custom quirk for now. Custom quirks take priority over built-in quirks though, so you'd want to eventually delete it. But it's generally not a major issue if you don't immediately delete it, even if the HA version already has the quirk included (or a newer version of it). You'll just be using the (potentially older) custom quirk until it's deleted.

Thanks for your detailed explanation.