Close
0%
0%

Your Air Pollution Sensor in Browser

Integrate any UART-based pollution sensor with polluSensWeb. Via simple JSON conf. —no coding, no special SW! Browser, USB-UART + sensor!

Similar projects worth following
polluSensWeb is a simple, no-fuss tool for reading and plotting data from UART air quality sensors—like PM2.5, VOCs, and similar stuff. It runs straight in your browser, so you don’t need to install anything. Just plug in your sensor, open the site, and go. You can load custom JSON configs for different sensors, parse raw binary frames (yes, with checksum control), and see live charts update in real time. Everything runs locally—no servers, no cloud, no nonsense.

PolluSensWeb: Visualize Your Air Sensor Data Right in the Browser

polluSensWeb is here to decode the bytes, draw the graphs, and help you breathe easy.
It is a lightweight, browser-based tool that talks directly to your UART air quality sensors (PM2.5, VOCs, temperature, humidity, etc). No installs, no drivers — just plug it in and open the page.

Imagine you’ve got an air quality sensor on your desk. It’s plugged in over USB, spitting out numbers through a UART connection. You want to see what it’s saying—PM2.5, VOCs, maybe some temperature data—but you don’t want to dig through hex dumps or write a bunch of code just to see a simple chart.

That’s exactly why polluSensWeb exists.

You open a web page. That’s it. No drivers. No apps. No command lines. Just Chrome or Edge or any browser that supports Web Serial. You pick your sensor from a dropdown, and instantly, your data comes alive. 

It reads raw binary frames, it logs every packet (make byte stuffing if needed) so you can peek under the hood. Want a chart with red for PM2.5 and blue for PM10 on the same chart? Just check a few boxes. Want to tweak the tension or line width?

 Click “Save CSV” and walk away with a full log—timestamps and all data.

It’s open-source, offline-friendly, and small enough to run on an old PC. Everything happens in your browser. 

Tinkering with sensors, wanting a faster way to see what’s really in the air around you?

So go ahead. Plug in a sensor. Open the browser and watch the air data come to live charts.

Live version (Chrome, Edge, Opera):
https://wespeakenglish.github.io/polluSensWeb/

Source code + config format:
https://github.com/WeSpeakEnglish/polluSensWeb

More sensors are coming to the default JSON :)

My video how to add a new sensor in 5 mins:

As for now supported following sensors already (in drop down list in web interface):

  • Panasonic SN-GCJA5
  • Honeywell HPMA115S0-XXX
  • Air Master AM7 Plus
  • Plantower PMSA003-S
  • Plantower PS3003A
  • Plantower PMS1003
  • Plantower PMS5003
  • Plantower PMS7003
  • Plantower PMS6003
  • Plantower PMS9103
  • Plantower PMS3003
  • Nova PM SDS011
  • Sensirion SPS30

New sensor configurations, bugs, or improvements? Feel free to fork the project, open an issue, send a pull request — or maybe star it on GitHub!

polluSensWeb-1.1.zip

x-zip-compressed - 12.89 kB - 07/01/2025 at 14:57

Download

  • New features implemented

    Aleksei Tertychnyi06/30/2025 at 15:58 1 comment

    1. Implemented limited log (1000 packets by default) 

    2. Auto scroll enable/disable for log

  • Do you have sensors at home? You may help!

    Aleksei Tertychnyi06/28/2025 at 03:28 0 comments

    Hello All,

    Do you have something from following sensors:
     MH-Z19 CO₂ sensor  
     MH-Z14 CO₂ sensor
     CM1106 CO₂ sensor
     SEN0231 (DF ROBOT HCHO sensor)
     ZE08B - HCHO
     ZPHS01C
     ZE08K-CH2O
     Cubic PM2008M-M
     Cubic PM2012SE-A
     HPMA115C0-004
     TERA Next PM

    If so, I’d be happy to assist you in creating a working configuration for it in polluSensWeb!
    If you’re using other serial-based sensors, please let me know which ones — I’d love if polluSensWeb will support more devices!
    Thank you in advance for any help or feedback — every bit counts!

    Best regards,
    Alex

  • New sensors coming

    Aleksei Tertychnyi06/28/2025 at 03:18 0 comments

    Currently ordered new SPS30 sensors , which still support UART, mine one looks not works, but will try better setup. Anyone may check sps30_need_to_check.json on gitHub. Please let me know if JSON works properly. Thank you!

View all 3 project logs

Enjoy this project?

Share

Discussions

Similar Projects

Does this project spark your interest?

Become a member to follow this project and never miss any updates