Home Assistant integration for Atmotube Pro devices from ATMO.
This integration is available in the default HACS repository.
- Use the My Home Assistant badge above, or from within Home Assistant, click on HACS
- Search for
Atmoand click on the appropriate repository - Click DOWNLOAD
- Restart Home Assistant
If you prefer manual installation:
- Download or clone this repository
- Copy the
custom_components/atmofolder to your Home Assistantcustom_componentsdirectory - Restart Home Assistant
⚠️ Manual installation will not provide automatic update notifications. HACS installation is recommended unless you have a specific need.
Once installed, your Atmotube device should be automatically discovered; simply add and confirm it when prompted.
If automatic discovery doesn't work, you can manually add the integration using the My Home Assistant badge below to jump directly to the setup.
Alternatively:
- Go to Settings > Devices & services
- In the bottom-right corner, select Add integration
- Type
Atmoand select the Atmo integration - Follow the instructions to add the integration to your Home Assistant
After this integration is set up, you can, optionally, configure the following:
- Enable polling - increases the precision on temperature and PM sensors by polling the Atmo device instead of relying on advertisement data exclusively.
| Name | Domain | Description |
|---|---|---|
| Air Quality Score | sensor | Composite score representing overall indoor air quality derived from multiple environmental measurements. |
| Battery | sensor | Current battery level of the Atmo device, reported as a percentage. |
| Battery Charging | sensor | Indicates whether the device battery is currently charging. |
| Humidity | sensor | Relative humidity of the surrounding air (%). |
| PM1 | sensor | Concentration of particulate matter smaller than 1.0 µm (μg/m³). |
| PM2.5 | sensor | Concentration of particulate matter smaller than 2.5 µm (μg/m³), commonly associated with health impacts. |
| PM10 | sensor | Concentration of particulate matter smaller than 10 µm (μg/m³). |
| Pressure | sensor | Ambient air pressure measured by the device. |
| Temperature | sensor | Ambient temperature measured by the device. |
| Volatile Organic Compounds (VOC) | sensor | Estimated concentration of volatile organic compounds in the air (ppb). |
I maintain this Home Assistant integration in my spare time. If you find it useful, consider supporting development:
- 💜 Sponsor me on GitHub
- ☕ Buy me a coffee / beer
- 💸 PayPal (direct support)
- ⭐ Star this project
- 📦 If you’d like to support in other ways, such as donating hardware for testing, feel free to reach out to me