MMM-AwairLocal

A MagicMirror² module that pulls air quality data from an Awair device using its Local API (no cloud dependency). This allows you to monitor air quality in real-time directly on your MagicMirror setup.

Features

✅ Pulls data from Awair's Local API (no cloud required)
✅ Displays air quality score, temperature, humidity, CO₂, VOC, and PM2.5
✅ Supports Celsius & Fahrenheit for temperature display
✅ Allows multiple Awair devices with configurable names
✅ Auto-refreshes at a configurable interval

Screenshot

Installation

Clone the repository:

cd ~/MagicMirror/modules
git clone https://github.com/YOUR_GITHUB/MMM-AwairLocal.git
cd MMM-AwairLocal

Install dependencies:

npm install

Enable the module in your MagicMirror config/config.js:

{
  module: "MMM-AwairLocal",
  position: "top_right", // Adjust as needed
  config: {
    awairIp: "192.168.1.2", // Local IP of your Awair device
    deviceName: "Living Room Awair", // Custom name for the device
    updateInterval: 60000, // Refresh data every 60 seconds
    showScore: true,  // Display air quality score
    showTemp: true,   // Display temperature
    showHumidity: true, // Display humidity
    showCO2: true,    // Display CO₂ levels
    showVOC: true,    // Display VOC levels
    showPM25: true,   // Display PM2.5 levels
    tempUnit: "F" // "C" for Celsius, "F" for Fahrenheit
  }
}

Multiple Devices Example

If you have multiple Awair devices, you can add multiple instances of the module:

{
  module: "MMM-AwairLocal",
  position: "top_right",
  config: {
    awairIp: "192.168.1.2",
    deviceName: "Living Room Awair",
    tempUnit: "F"
  }
},
{
  module: "MMM-AwairLocal",
  position: "bottom_right",
  config: {
    awairIp: "192.168.1.3",
    deviceName: "Bedroom Awair",
    tempUnit: "F"
  }
}

Notes

• Make sure the Local API is enabled on your Awair device (Awair+ tab in the Awair app).
• The device must be on the same network as your MagicMirror.
• This module does not use the cloud and relies entirely on the local API.