Fork me on GitHub

pimatic-hongkongpollution by Andy Savage (hongkongkiwi) | github | npm


Hong Kong Pollution Readings and Forecasts for Pimatic. This plugin uses the node.js module hongkong-pollution to grab the information.

Data is taken from the Hong Kong Environmental Departments Website and RSS feed. In Hong Kong, pollution is a big consideration as it is for many large cities. The reason for developing this module is so that you can have reminders to wear a pollution mask, stay indoors or combine it with other modules in Pimatic so you can automatically turn on the indoor Air Filter.

Plugin Configuration

You can load the plugin by editing your config.json to include:

   "plugin": "hongkongpollution"

in the plugins Array.

Device Configuration

Devices can be added by adding them to the devices Array in the config file. Set the class property to PollutionForecastDevice or PollutionReadingsDevice

For device configuration options see the device-config-schema file.

Device examples

Pollution Forecast Device

This gives you a general forecast of the AQHI for the whole day, including a human friendly "Risk" as well as the aggregated AQHI reading.

  "id": "pollution-forecast",
  "name": "HK Pollution Forecast",
  "class": "PollutionForecastDevice",

The following optional settings are available. For more information see device-config-schema.

  "showRoadsideAQHI": true,
  "showGeneralAQHI": true,
  "showRoadsideRisk": true,
  "showGeneralRisk": true,
  "updateInterval": 3600,
  "language": "en"

Pollution Readings Device

This allows you to show all pollution readings for a specific area such as PM2.5,PM10,NO2,SO2,O3,CO.

The most important setting is which reporting station to use. Click here for more information about which reporting station to use for your district. The example below uses the "Sham Sha Po" monitoring station.

  "id": "pollution-readings",
  "name": "HK Pollution Readings",
  "class": "PollutionReadingsDevice",
  "reportingStation": "Sham Sha Po"

The following optional settings are available. For more information see device-config-schema.

  "updateInterval": 3600,
  "showNO2": true,
  "showCO": true,
  "showSO2": true,
  "showO3": true,
  "showPM2_5": true,
  "showPM10": true,
  "showAQHI": true

Air Quality information


  • Add Beach Water Quality
  • Add some pretty graphics to the front-end (how can I do this?)
  • Support rules so we can automate things using the readings from this module (need to do more research on how this works)
  • I would love to have some way to test using Mocha, right now this seems impossible.


Feel free to submit any pull requests or add functionality, I'm usually pretty responsive.

If you like the module, please consider donating some bitcoin or litecoin.





Plugin Config Options

Hong Kong Weather Config Options
Debug mode. Writes debug messages to the pimatic log, if set to true.
pimatic-hongkongpollution is written by Andy Savage (hongkongkiwi)