Nostradamus Predicting Maelstroms
Wondering what’s next for npm?Check out our public roadmap! »


2.3.2 • Public • Published


npm npm verified-by-homebridge

Homebridge Plugin for Philips Air Purifiers

This plugin is now using py-air-control directly to enable support for newer Philips connected air purifier models.


  1. Install Homebridge using the official instructions.
  2. Install this plugin using sudo npm install -g homebridge-philips-air --unsafe-perm.
  3. Update your configuration file. See configuration sample below.

If you are using CoAP or Plain CoAP:

  1. Install pip and git using sudo apt install python3-pip git.
  2. Install py-air-control using sudo pip3 install py-air-control.
  3. Update CoAPthon3 using sudo pip3 install -U git+

Plain CoAP users only will also need to do:

  1. Allow non-root to send pings using echo "net.ipv4.ping_group_range=0 1000" | sudo tee -a /etc/sysctl.conf.
  2. Update running sysctl configuration using sudo sysctl -p.

If you're only using HTTP, no additional steps are required.


Edit your config.json accordingly. Configuration sample:

    "platform": "philipsAir",
    "devices": [{
        "name": "Living Room Purifier",
        "ip": "",
        "protocol": "http"
Fields Description Required
platform Must always be philipsAir. Yes
name For logging purposes. No
timeout_seconds Number of seconds to wait for a response from the purifier. (Default: 5) No
devices Array of Philips air purifiers (multiple supported). Yes
|- name Name of your device. No
|- ip IP address of your device. Yes
|- protocol Protocol used by your device: http (default), plain_coap, coap No
|- sleep_speed Does this device support 'sleep' speed? No
|- light_control Expose device lights as lightbulbs. No


npm i homebridge-philips-air

DownloadsWeekly Downloads






Unpacked Size

62.3 kB

Total Files


Last publish


  • avatar