Support air purifier device type in homekit

While I think it would be great for HomeKit Bridge to support air purifiers, I would hesitate to endorse a system that automatically assumes just because an air quality sensor is present with a fan it means the device is an air purifier — I have air purifiers without built-in sensors, and I also added a PMS7001 to my range extraction fan but it doesn’t do any purification so I would prefer it still appear as a fan despite the co-existent sensor.

Instead I could envision an option similar to HomeKit valve support, which gives you the option to declare a switch as a valve type when bridging to HomeKit in accessory mode. Similarly, it would make sense to have the option to bridge a fan to HomeKit as an air purifier, for example something like this:

homekit:
  - name: "Fan as Air Purifier"
    port: 12345
    mode: accessory
    filter:
      include_entities:
         - fan.custom_fan_name
         - sensor.optional_pm_2.5_sensor
    entity_config:
      fan.custom_fan_name:
         type: air_purifier
4 Likes

Any update on this matter? I’ve tried Aki’s code but did not work with my Levoit Vital 100s

Hi, I tried this and it didn’t work. I believe I did everything right but can you explain it step-by-step what we should do? I’m trying to connect my IKEA Air Purifier but even with z2m and homebridge it doens’t work. With HA appears has a fan and with homebridge only appears the sensors.
Thank you for your work and help would be much apreciated.

any new on this item?

I have a xiaomi purifier 3h

thanks

How many votes does a thing require before it becomes a suggestion worthy of being an actual change?

1 Like

Is it necessary to copy the entire directory or just the type_air_purifiers.py file?

Any update on this request?

There are two other feature requests for the same topic:
Add Air Purifier as device type to Homekit Bridge integration and
Add Air Purifier to HomeKit Bridge
Can we merge them here?

1 Like

The new 2025.5 version now supports air purifier – thanks to the PR. However the domain doesn’t pop up in my homekit bridge – does anyone know how to use it?

I have made the update and love it.
Unfortunately my Dyson air purifier comes up as a switch with an air purifier inside, thus showing a switch accessory in the home app.
I think it’s because the air purifier accessory is not the primary accessory.
Anyone with the same issue?

Yes, having the same issue with a Xiaomi Smart Air Purifier 4. I just activate ‘show as separate tiles’ and hide the additional switch buttons in the Home App.

According to the PR: Fans with an attached PM2.5 sensor are automatically exposed as air purifiers.

I missed that phrase lol – thank you! however as my air purifiers (winix * 2) don’t have PM2.5 sensor I have to do some manual work I guess – still trying to figure that out

Fans with an attached PM2.5 sensor are automatically exposed as air purifiers, but this can be customized via the configuration

looks like only humidity, pm2.5 and temperature sensors are supported to generate a air purifier with a fan

I did the same. Can you switch the air purifier mode in the air purifier card? On mine it only turns on and off and adjusts the speed.