{"id":15643075,"url":"https://github.com/raresail/homebridge-levoit-air-purifier","last_synced_at":"2025-04-05T04:08:39.110Z","repository":{"id":40651126,"uuid":"425814987","full_name":"RaresAil/homebridge-levoit-air-purifier","owner":"RaresAil","description":"A Homebridge platform plugin made for Levoit Air Purifiers which supports the following models: Core 200S/300S/400S/400S Pro","archived":false,"fork":false,"pushed_at":"2025-01-30T17:56:39.000Z","size":263,"stargazers_count":73,"open_issues_count":16,"forks_count":15,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-29T03:02:36.199Z","etag":null,"topics":["200s","300s","400s","401s","air-purifier","api","homebridge-plugin","levoit","typescript","vesync"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/homebridge-levoit-air-purifier","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RaresAil.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":["https://revolut.me/nicolanuyi"]}},"created_at":"2021-11-08T11:43:18.000Z","updated_at":"2025-03-23T01:51:32.000Z","dependencies_parsed_at":"2025-02-16T05:01:59.598Z","dependency_job_id":"fa00bdd8-b5e9-449e-aba5-4f431a783cd2","html_url":"https://github.com/RaresAil/homebridge-levoit-air-purifier","commit_stats":{"total_commits":39,"total_committers":3,"mean_commits":13.0,"dds":0.4358974358974359,"last_synced_commit":"2d90816a831b0b65d5546958ca16ca62b9005515"},"previous_names":[],"tags_count":31,"template":false,"template_full_name":"homebridge/homebridge-plugin-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RaresAil%2Fhomebridge-levoit-air-purifier","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RaresAil%2Fhomebridge-levoit-air-purifier/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RaresAil%2Fhomebridge-levoit-air-purifier/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RaresAil%2Fhomebridge-levoit-air-purifier/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RaresAil","download_url":"https://codeload.github.com/RaresAil/homebridge-levoit-air-purifier/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247284944,"owners_count":20913704,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["200s","300s","400s","401s","air-purifier","api","homebridge-plugin","levoit","typescript","vesync"],"created_at":"2024-10-03T11:58:52.154Z","updated_at":"2025-04-05T04:08:39.061Z","avatar_url":"https://github.com/RaresAil.png","language":"TypeScript","funding_links":["https://revolut.me/nicolanuyi"],"categories":[],"sub_categories":[],"readme":"[![verified-by-homebridge](https://badgen.net/badge/homebridge/verified/purple)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)\n\n[![Build and Lint](https://github.com/RaresAil/homebridge-levoit-air-purifier/actions/workflows/build.yml/badge.svg)](https://github.com/RaresAil/homebridge-levoit-air-purifier/actions/workflows/build.yml)\n[![CodeQL](https://github.com/RaresAil/homebridge-levoit-air-purifier/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/RaresAil/homebridge-levoit-air-purifier/actions/workflows/codeql-analysis.yml)\n\n![NPM Package Downloads](https://badgen.net/npm/dm/homebridge-levoit-air-purifier)\n![Snyk Vulnerabilities for NPM Package](https://img.shields.io/snyk/vulnerabilities/npm/homebridge-levoit-air-purifier)\n\n# Homebridge Levoit Air Purifier\n\nThis is a Homebridge plugin to control Levoit Air Purifiers/Humidifiers with via the VeSync Platform.\n\n| Supported Versions | Tested |\n| ------------------ | ------ |\n| Core 600S          | ✅     |\n| Core 400S Pro      | ✅     |\n| Core 400S          | ✅     |\n| Core 300S          | ✅     |\n| Core 200S          | ✅     |\n| Other versions     | ❌     |\n\n**The versions lower then 200 are not supported (e.g. 131S) because they require API v1 and this plugin uses v2**\n\n**If you have a newer version that is not in this table, then open a issue\nand i will try to add support for it**\n\nAny device from VeSync that is not listed in the supported versions are automatically skipped when discovering devices.\n\n### Features for Purifiers\n\n1. Displaying the air quality (the same display as the one on the physical device) (Not for 200S)\n2. Display the PM2.5 Density value in Home App shown in µg/m^3 (Not for 200S)\n3. Child Lock option\n4. Speed option:\n   - 0 -\u003e Off\n   - 1 -\u003e Sleep Mode\n   - 2 -\u003e Level 1\n   - 3 -\u003e Level 2\n   - 4 -\u003e Level 3\n   - 5 -\u003e Level 4 (Only for Core 400S, 400S Pro and 600S)\n5. Filter Change Indicator \u0026 Filter Life Level\n6. Mode change (Not for 200S)\n   - Auto\n   - Manual\n\n### Humidifiers (Experimental Feature)\n\nThe version 2.x adds support for humidifiers as an experimental feature which by default is disabled, the devices and features are limited for this devices for now\n\n| Supported Versions | Tested |\n| ------------------ | ------ |\n| Dual 200S          | ✅     |\n| Other versions     | ❌     |\n\n**If you have a newer version that is not in this table, then open a issue\nand i will try to add support for it**\n\n#### Features\n\n1. Displaying the humidity level\n2. Target Humidity\n3. Speed option:\n   - 0 -\u003e Off\n   - 1 -\u003e LOW\n   - 2 -\u003e HIGH\n4. Mode change as Swing in home app\n   - Auto (Swing enabled)\n   - Manual (Swing disabled)\n\n### Experimental Features\n\nFor the experimental features to be activated you need to add them in the config file of the platform, e.g.\n\n```json\n{\n  \"name\": \"Levoit Air Purifiers\",\n  \"experimentalFeatures\": [\"DeviceDisplay\", \"Humidifiers\"]\n}\n```\n\n---\n\n1. Show the display's switch as a light in the app (`DeviceDisplay`)\n\nThe read data is cached for 5 seconds to not trigger the rate limiter for the API.\nEach request is delayed by 500ms to not trigger the rate limiter if a huge number of requests are sent.\n\nThe timers are not included because you can accomplish similar results by using Home App's Automatization or the Shortcuts app\n\n2. Discovers supported humidifiers (`Humidifiers`)\n\n### Configuration\n\n- Via the Homebridge UI, enter the Homebridge VeSync Client plugin settings.\n- Enter your VeSync app credentials.\n- Setup the platform plugin as a child bridge for better performance\n- Save and restart Homebridge.\n\nThis plugin requires your VeSync credentials as it communicates with the VeSync devices via VeSync's own API. Your credentials are only stored in the Homebridge config and not sent to any server except VeSync's.\n\nYou can also do this directly via the homebridge config by adding your credentials to the config file under platforms. Replace the values of `username` and `password` by your credentials.\n\n```json\n{\n  \"platforms\": [\n    {\n      \"name\": \"Levoit Air Purifiers\",\n      \"email\": \"email\",\n      \"password\": \"password\",\n      \"platform\": \"LevoitAirPurifiers\",\n      \"experimentalFeatures\": []\n    }\n  ]\n}\n```\n\n### Enabling Debug Mode\n\nIn the config file, add `enableDebugMode: true`\n\n```json\n{\n  \"platforms\": [\n    {\n      \"name\": \"Levoit Air Purifiers\",\n      \"email\": \"email\",\n      \"password\": \"password\",\n      \"platform\": \"LevoitAirPurifiers\",\n      \"enableDebugMode\": true\n    }\n  ]\n}\n```\n\n### Local Development\n\nTo setup the local project clone the files and inside the root directory of the project run:\n\n```\nyarn install\n```\n\nAfter that to start the local server use\n\n```\nyarn watch\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraresail%2Fhomebridge-levoit-air-purifier","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraresail%2Fhomebridge-levoit-air-purifier","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraresail%2Fhomebridge-levoit-air-purifier/lists"}