{"id":51141109,"url":"https://github.com/ovflowd/switchbot-cover-integration","last_synced_at":"2026-06-25T23:01:54.248Z","repository":{"id":366684623,"uuid":"1277374513","full_name":"ovflowd/switchbot-cover-integration","owner":"ovflowd","description":"Home Assistant custom integration for SwitchBot-based roller shutters with contact sensor feedback","archived":false,"fork":false,"pushed_at":"2026-06-22T21:35:39.000Z","size":8,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-22T23:17:12.801Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ovflowd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"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":"2026-06-22T20:53:34.000Z","updated_at":"2026-06-22T21:35:43.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ovflowd/switchbot-cover-integration","commit_stats":null,"previous_names":["ovflowd/switchbot-cover-integration"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/ovflowd/switchbot-cover-integration","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ovflowd%2Fswitchbot-cover-integration","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ovflowd%2Fswitchbot-cover-integration/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ovflowd%2Fswitchbot-cover-integration/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ovflowd%2Fswitchbot-cover-integration/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ovflowd","download_url":"https://codeload.github.com/ovflowd/switchbot-cover-integration/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ovflowd%2Fswitchbot-cover-integration/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34795436,"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-25T02:00:05.521Z","response_time":101,"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":[],"created_at":"2026-06-25T23:01:53.404Z","updated_at":"2026-06-25T23:01:54.230Z","avatar_url":"https://github.com/ovflowd.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SwitchBot Cover Integration for Home Assistant\n\nA custom Home Assistant integration that creates unified cover entities from pairs of SwitchBot Bot switches (up/down) with optional contact sensor feedback.\n\n## Why?\n\nMany roller shutters use wall-mounted buttons — one for up, one for down. SwitchBot Bots can press these buttons via BLE, but each Bot appears as an independent `switch` entity in Home Assistant. This integration wraps a pair of SwitchBot switches into a proper `cover` entity with:\n\n- **Open / Close / Stop** controls\n- **Movement lockout** — prevents conflicting up/down commands while the shutter is moving\n- **Contact sensor feedback** — tracks open/closed state via an optional door/window sensor\n- **Position support** — binary position (0% or 100%) based on the contact sensor\n- **UI configuration** — no YAML editing required\n\n## Installation\n\n### HACS (recommended)\n\n1. Open HACS in Home Assistant\n2. Go to **Integrations** → **⋮** → **Custom repositories**\n3. Add `https://github.com/ovflowd/switchbot-cover-integration` as an **Integration**\n4. Search for \"SwitchBot Cover\" and install\n5. Restart Home Assistant\n\n### Manual\n\n1. Copy `custom_components/switchbot_cover/` to your Home Assistant `custom_components/` directory\n2. Restart Home Assistant\n\n## Configuration\n\n1. Go to **Settings** → **Devices \u0026 Services** → **Add Integration**\n2. Search for **SwitchBot Cover**\n3. Fill in:\n   - **Cover name** — friendly name (e.g., \"Bedroom Rollers\")\n   - **Up switch** — the SwitchBot switch entity that opens the shutter\n   - **Down switch** — the SwitchBot switch entity that closes the shutter\n   - **Contact sensor** (optional) — a binary sensor that detects shutter position (`on` = open, `off` = closed)\n   - **Movement timeout** — seconds to wait for movement to complete (default: 30s)\n4. Click **Submit**\n\nRepeat for each roller shutter. The contact sensor and timeout can be changed later via the integration's options.\n\n## How it works\n\nWhen you send an **open** or **close** command:\n\n1. The integration checks the movement lock — if the shutter is already moving, the command is ignored\n2. The lock is acquired\n3. The corresponding SwitchBot switch is toggled (simulating a button press)\n4. The integration waits for the contact sensor to report the expected state, or for the timeout to elapse\n5. The lock is released\n\n**Stop** re-toggles the active direction switch, which on most roller shutter controllers acts as a stop command.\n\n**Position** is binary: 100% (open) or 0% (closed), derived from the contact sensor. `set_position` with a value \u003e 50% opens, ≤ 50% closes.\n\n## Requirements\n\n- Two SwitchBot Bot switches per roller shutter (configured via the SwitchBot BLE integration)\n- Optionally, a contact/door sensor attached to the shutter for state feedback\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fovflowd%2Fswitchbot-cover-integration","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fovflowd%2Fswitchbot-cover-integration","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fovflowd%2Fswitchbot-cover-integration/lists"}