{"id":15628286,"url":"https://github.com/pschroeder89/homebridge-levoit-humidifiers","last_synced_at":"2025-04-05T00:05:29.687Z","repository":{"id":42979686,"uuid":"428512569","full_name":"pschroeder89/homebridge-levoit-humidifiers","owner":"pschroeder89","description":"Levoit Humidifiers Plugin for Apple HomeKit via Homebridge","archived":false,"fork":false,"pushed_at":"2025-01-21T18:16:44.000Z","size":1799,"stargazers_count":83,"open_issues_count":1,"forks_count":11,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-28T23:04:12.702Z","etag":null,"topics":["homebridge","homebridge-humidifiers","homebridge-plugin","homebridge-plugins","humidifier","humidifiers","levoit"],"latest_commit_sha":null,"homepage":"","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/pschroeder89.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":{"github":["pschroeder89"],"custom":["https://www.paypal.me/pschroeder89"]}},"created_at":"2021-11-16T04:07:32.000Z","updated_at":"2025-03-25T21:37:32.000Z","dependencies_parsed_at":"2023-12-25T23:20:32.743Z","dependency_job_id":"dc0432a9-f81d-4862-90a7-0735b5c09d18","html_url":"https://github.com/pschroeder89/homebridge-levoit-humidifiers","commit_stats":{"total_commits":149,"total_committers":7,"mean_commits":"21.285714285714285","dds":"0.38926174496644295","last_synced_commit":"4d8ae3b310c84e9afa001cb7b8a8d9770b6adcb9"},"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pschroeder89%2Fhomebridge-levoit-humidifiers","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pschroeder89%2Fhomebridge-levoit-humidifiers/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pschroeder89%2Fhomebridge-levoit-humidifiers/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pschroeder89%2Fhomebridge-levoit-humidifiers/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pschroeder89","download_url":"https://codeload.github.com/pschroeder89/homebridge-levoit-humidifiers/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247266562,"owners_count":20910836,"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":["homebridge","homebridge-humidifiers","homebridge-plugin","homebridge-plugins","humidifier","humidifiers","levoit"],"created_at":"2024-10-03T10:21:46.576Z","updated_at":"2025-04-05T00:05:29.663Z","avatar_url":"https://github.com/pschroeder89.png","language":"TypeScript","funding_links":["https://github.com/sponsors/pschroeder89","https://www.paypal.me/pschroeder89"],"categories":[],"sub_categories":[],"readme":"# Homebridge Levoit Humidifiers\n\n[![verified-by-homebridge](https://badgen.net/badge/homebridge/verified/purple)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)\n[![Discord](https://discordapp.com/api/guilds/432663330281226270/widget.png?style=shield)](https://discord.com/channels/432663330281226270/1055705874460594247)\n[![downloads-via-npm](https://img.shields.io/npm/dt/homebridge-levoit-humidifiers)](https://www.npmjs.com/package/homebridge-levoit-humidifiers)\n\nThis is a Homebridge plugin to control Levoit Humidifiers from Apple HomeKit.\n\n| Supported Versions | Auto / Humidity | Mist | Sleep | Light | Display | Warm |\n| ------------------ | --------------- | ---- | ----- | ----- | ------- | ---- |\n| Superior 6000S     | ✅              | ✅   | ✅    | ❌    | ✅      | ❌   |\n| OasisMist 1000S    | ✅              | ✅   | ✅    | ❌    | ✅      | ❌   |\n| OasisMist 600S     | ✅              | ✅   | ✅    | ❌    | ✅      | ✅   |\n| OasisMist 450S     | ✅              | ✅   | ✅    | ❌    | ✅      | ✅   |\n| LV600S             | ✅              | ✅   | ✅    | ❌    | ✅      | ✅   |\n| Classic 300S       | ✅              | ✅   | ✅    | ✅    | ✅      | ❌   |\n| Classic 200S       | ✅              | ✅   | ❌    | ❌    | ✅      | ❌   |\n| Dual 200S          | ✅              | ✅   | ❌    | ✅    | ✅      | ❌   |\n\n### Features (if supported by model)\n\n1. Humidifier / Auto Mode\n    - Sets humidifier to Auto / Humidity and sets the Target Humidity to the desired level.\n    - Can also change Target Humidity in Sleep Mode, except on LV600 / Oasis.\n        - For LV600s and Oasis, the Humidifier slider will be set to 0% when Sleep Mode is on.\n    - For LV600s and Oasis, the Auto humidity range is 40-80%. All other models are 30-80%.\n        - Selecting values outside the Auto range will set the Target Humidity to the lowest or highest number in the\n          range.\n\n2. Mist Level\n    - Sets humidifier to Manual mode unless model supports changing mist levels in Auto / Humidity mode, and sets Mist level.\n    - When set to Level 0, turns the device off.\n\n3. Warm Mist Level\n    - Sets Warm Mist Level to the desired level.\n\n4. Sleep Mode\n    - This switches the device between Sleep Mode (On) and Auto Mode (Off)\n    - Sleep Mode Target Humidity is controlled by the Target Humidity slider, except on LV600s / Oasis.\n    - On LV600s / Oasis, Sleep Mode Target Humidity is set by VeSync at 50–60% and cannot be changed.\n    - The LV600s / Oasis turns off Warm Mist by default to keep the humidifier quiet. It can be turned back on with the Warm\n      Mist slider.\n\n5. Night Light\n    - 4 brightness levels\n\n6. Display Toggle\n    - Toggles the display on/off\n\n7. Humidity Sensor\n    - Sensor that displays current Humidity %\n\n### Details\n\n\u003ca href=\"url\"\u003e\u003cimg src=\"images/services2.png\" width=25% height=25%\u003e\u003c/a\u003e\n\u003ca href=\"url\"\u003e\u003cimg src=\"images/auto.png\" width=25% height=25%\u003e\u003c/a\u003e\n\u003ca href=\"url\"\u003e\u003cimg src=\"images/manual.png\" width=25% height=25%\u003e\u003c/a\u003e\n\u003ca href=\"url\"\u003e\u003cimg src=\"images/display.png\" width=25% height=25%\u003e\u003c/a\u003e\n\u003ca href=\"url\"\u003e\u003cimg src=\"images/light.png\" width=25% height=25%\u003e\u003c/a\u003e\n\u003ca href=\"url\"\u003e\u003cimg src=\"images/sleep.png\" width=25% height=25%\u003e\u003c/a\u003e\n\u003ca href=\"url\"\u003e\u003cimg src=\"images/services.png\" width=25% height=25%\u003e\u003c/a\u003e\n\n### Configuration\n\n* Via the Homebridge UI, enter the Homebridge VeSync Client plugin settings.\n* Enter your VeSync app credentials.\n* Select which controls you want exposed. Humidity / Auto Mode can not be hidden.\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\ncredentials 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.\nReplace the values of `username` and `password` with your credentials.\n\nYou can turn off optional controls via the `accessories` section of the config or through the plugin UI settings. The\nHumidifier (Auto mode) slider cannot be turned off and will always be exposed.\n\nVia UI:\n\n\u003cimg src=\"images/homebridgeUI.png\" width=\"500\"/\u003e\n\nVia config.json:\n\n```json\n{\n  \"platforms\": [\n    {\n      \"name\": \"Levoit Humidifiers\",\n      \"email\": \"email\",\n      \"password\": \"password\",\n      \"platform\": \"LevoitHumidifiers\",\n      \"accessories\": {\n        \"display\": false,\n        \"sleep_mode\": false,\n        \"mist\": false,\n        \"warm_mist\": false,\n        \"night_light\": false,\n        \"auto_pro\": false,\n        \"humidity_sensor\": true\n      },\n      \"options\": {\n        \"showOffWhenDisconnected\": false\n      }\n    }\n  ]\n}\n```\n\n### Note to Seasonal Humidifier Users:\n\nBy default, if you disconnect a humidifier from WiFi, it will begin showing as \"Not Responding\" in HomeKit. Restarting\nHomebridge will remove the cached device from HomeKit. Once you've re-connected the humidifier, restart Homebridge again\nfor it to display back in HomeKit. \n\nIf you prefer the disconnected device to be visible in HomeKit at all times, \nset `showOffWhenDisconnected` to `true` in the config. The humidifiers will remain in HomeKit in an Off state.\n**Note: This will cause benign errors in the Homebridge logs that the device could not be contacted.**\n\n### Enabling Debug Mode\n\nIn the config file, add `enableDebugMode: true`\n\n```json\n{\n  \"platforms\": [\n    {\n      \"name\": \"Levoit Humidifiers\",\n      \"email\": \"email\",\n      \"password\": \"password\",\n      \"platform\": \"LevoitHumidifiers\",\n      \"enableDebugMode\": true\n    }\n  ]\n}\n```\n\n### Local Development\n\nTo setup the local project, clone this repo and run the following from the root directory:\n\n```\nyarn install\n```\n\nTo run locally, make sure to install Homebridge locally, and then run:\n\n```\nyarn watch\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpschroeder89%2Fhomebridge-levoit-humidifiers","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpschroeder89%2Fhomebridge-levoit-humidifiers","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpschroeder89%2Fhomebridge-levoit-humidifiers/lists"}