{"id":13584986,"url":"https://github.com/dahlb/ha_blueair","last_synced_at":"2026-06-07T23:01:35.094Z","repository":{"id":40442529,"uuid":"485895021","full_name":"dahlb/ha_blueair","owner":"dahlb","description":"Home Assistant Integration for Blueair","archived":false,"fork":false,"pushed_at":"2026-06-02T19:52:42.000Z","size":411,"stargazers_count":106,"open_issues_count":13,"forks_count":21,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-06-02T21:28:09.054Z","etag":null,"topics":["blueair","hacs-integration","hassio-integration","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dahlb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-04-26T18:01:39.000Z","updated_at":"2026-06-02T19:50:39.000Z","dependencies_parsed_at":"2026-01-25T15:03:51.982Z","dependency_job_id":null,"html_url":"https://github.com/dahlb/ha_blueair","commit_stats":{"total_commits":177,"total_committers":7,"mean_commits":"25.285714285714285","dds":0.5028248587570621,"last_synced_commit":"fc481b9a7cdd72f1538384f192b7cf83835f6c91"},"previous_names":[],"tags_count":154,"template":false,"template_full_name":null,"purl":"pkg:github/dahlb/ha_blueair","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dahlb%2Fha_blueair","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dahlb%2Fha_blueair/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dahlb%2Fha_blueair/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dahlb%2Fha_blueair/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dahlb","download_url":"https://codeload.github.com/dahlb/ha_blueair/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dahlb%2Fha_blueair/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34041089,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-07T02:00:07.652Z","response_time":124,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blueair","hacs-integration","hassio-integration","python3"],"created_at":"2024-08-01T15:04:38.698Z","updated_at":"2026-06-07T23:01:35.030Z","avatar_url":"https://github.com/dahlb.png","language":"Python","funding_links":["https://www.buymeacoffee.com/dahlb"],"categories":["Python"],"sub_categories":[],"readme":"\u003cimg src=\"https://img.shields.io/badge/dynamic/json?color=41BDF5\u0026logo=home-assistant\u0026label=integration%20usage\u0026suffix=%20installs\u0026cacheSeconds=15600\u0026url=https://analytics.home-assistant.io/custom_integrations.json\u0026query=$.ha_blueair.total\"\u003e\n\n[![GitHub Release][releases-shield]][releases]\n[![GitHub Activity][commits-shield]][commits]\n[![License][license-shield]](LICENSE)\n[![hacs][hacsbadge]][hacs]\n\n![Project Maintenance][maintenance-shield]\n[![BuyMeCoffee][buymecoffeebadge]][buymecoffee]\n\nA custom integration for Blueair Filters.  If your model isn't reported correctly please open a ticket and include your model name and the diagnostic file from the integration.\n\n## Feature Highlights ##\n- fan\n  - speed\n  - turn off/on\n  - preset modes: night/auto (if supported)\n- light\n  - brightness\n  - turn off/on\n- sensors\n  - Filter Replacement\n  - Humidity\n  - Connectivity\n  - Temperature\n  - PM 1\n  - PM 2.5\n  - PM 10\n  - VOC\n- switches\n  - child lock\n  - germ shield\n  - wick dry\n- climate (T10i/T20i only)\n- humidifier (H35i/H76i only)\n\n## Installation ##\nYou can install this either manually copying files or using HACS. Configuration can be done on UI, you need to enter your username and password, (I know, translations are missing).\n\n## Beta / Pre-release Builds ##\n\nSome changes are easier to validate with a small group of opt-in testers before\nthey ship to everyone. Those changes are published as **pre-release** builds that\nonly appear for users who have turned on beta versions in HACS. Normal users are\nnever offered a pre-release and stay on the latest stable build.\n\n### Installing a beta as a tester (HACS) ###\n\n1. In Home Assistant, open **HACS** and find **Blueair Filters** under\n   Integrations.\n2. Open the three-dot menu on the integration and choose **Redownload**\n   (some HACS versions label this **Update information** / **Reinstall**).\n3. Enable the **Show beta versions** toggle in that dialog.\n4. Pick the beta version (for example `1.51.0-beta.1`) from the version list and\n   download it.\n5. Restart Home Assistant.\n\nTo return to a stable build, repeat the steps with **Show beta versions** turned\noff, select the latest non-beta version, and restart.\n\n\u003e When reporting on a beta, include the exact version string and a diagnostics\n\u003e download (see [Troubleshooting](#troubleshooting-)) so issues are easy to trace.\n\n### Publishing a beta (maintainers) ###\n\nStable releases are unchanged: a push to `main` runs the **Release** workflow,\nwhich derives the next version from the conventional-commit history and publishes\na normal (non-pre-release) GitHub Release.\n\nPre-releases are cut manually from a feature branch so they never reach stable\nusers:\n\n1. Push the change to a feature branch (do **not** merge to `main` yet).\n2. Go to **Actions -\u003e Release -\u003e Run workflow**.\n3. Select that feature branch as the workflow ref.\n4. In **Pre-release version**, enter a version with a suffix, e.g.\n   `1.51.0-beta.1` (the suffix may be `-alpha`, `-beta`, or `-rc`).\n5. Run it. The workflow bumps `manifest.json` on that branch, tags\n   `v1.51.0-beta.1`, and creates a GitHub Release that is **automatically marked\n   as a pre-release** because of the suffix. HACS then offers it only to users\n   with **Show beta versions** enabled.\n\nWhen validation is complete, merge the branch to `main`; the normal push-to-main\nflow then publishes the stable version the usual way.\n## Limitations ##\nIf you receive an error while trying to login, try resetting your password to one with no special characters except '!' and no longer then 10 characters.\n\n## Troubleshooting ##\nIf you receive an error, please go through these steps;\n1. Enabled Debug Logging, at /config/integrations/integration/ha_blueair\n2. Restart you home assistant to capture initialization with debug logging, then try to do what your having trouble with\n3. Disable Debug Logging, at /config/integrations/integration/ha_blueair (which will download the logs)\n4. Click the three dots menu for your device, at /config/integrations/integration/ha_blueair\n5. Click Download Diagnostics\n6. Attach both logs and diagnostics to your issue ticket.\n\n***\n\n[ha_blueair]: https://github.com/dahlb/ha_blueair\n[commits-shield]: https://img.shields.io/github/commit-activity/y/dahlb/ha_blueair.svg?style=for-the-badge\n[commits]: https://github.com/dahlb/ha_blueair/commits/main\n[hacs]: https://github.com/hacs/integration\n[hacsbadge]: https://img.shields.io/badge/HACS-Default-41BDF5.svg?style=for-the-badge\n[forum]: https://community.home-assistant.io/\n[license-shield]: https://img.shields.io/github/license/dahlb/ha_blueair.svg?style=for-the-badge\n[maintenance-shield]: https://img.shields.io/badge/maintainer-Bren%20Dahl%20%40dahlb-blue.svg?style=for-the-badge\n[releases-shield]: https://img.shields.io/github/release/dahlb/ha_blueair.svg?style=for-the-badge\n[releases]: https://github.com/dahlb/ha_blueair/releases\n[buymecoffee]: https://www.buymeacoffee.com/dahlb\n[buymecoffeebadge]: https://img.shields.io/badge/buy%20me%20a%20coffee-donate-yellow.svg?style=for-the-badge\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdahlb%2Fha_blueair","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdahlb%2Fha_blueair","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdahlb%2Fha_blueair/lists"}