Skip to main content

PurpleAir

Display sensor data from the PurpleAir Ecosystem

I
Written by Ikraam Ghoor
Updated yesterday

Step 1 - Visit the PurpleAir Plugin

Inside TRMNL, navigate to Plugins > PurpleAir.

Step 2 - Hop over to the developer dashboard for the API key

NB: TRMNL is very careful about the PurpleAir API usage. The first call fetches the last 24 hours. Subsequent calls only fetch the delta since last request (up to 24 hours). The estimated depletion time for the free credits is 2.5 years.

Purple Air API key for TRMNL

Step 3 - Select the sensor ID that you would be viewing

You can find the Sensor ID from the PurpleAir Map URL. Example URL:

Or via the MAP UI:

sensor id for purpleair trmnl

Step 3 - Fill in the plugin Form on the TRMNL Dashboard

Fill in the sensor id and the API key that we have obtained above. The "Read Key (Private Sensors)" is optional that is required only for sensors that are private to you.

Step 4 - You're Done!

Based on your device's refresh settings, you'll begin seeing PurpleAir data very soon. Breathe easy!

Did this answer your question?