SwitchBot Remote IR
KiraPC/ha-switchbot-remote · v1.3.7
A Custom HomeAssistant Integration to control Switchbot Hub
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
light | Light | |
climate | Thermostat | |
fan | Fan | |
media_player | TV, receiver or media switches | Needs its own HomeKit Bridge in accessory mode |
remote | TV remote (activities) | Needs its own HomeKit Bridge in accessory mode |
vacuum | Vacuum (as a switch) | |
water_heater | Water heater (as a thermostat) | |
button | Button (as a switch) |
1 report below say how a device from this integration behaves in the Home app.
What people report
Controls SwitchBot IR remotes via the cloud API; basic commands work but learned custom buttons can fail. Room temperature shown in HomeKit needs an external sensor.
- Works1
- Partly works2
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| SwitchBot IR fan | Works Cloud | Fan support with swing toggle and safer turn-on speedSaved copyDescription This PR is a supplement to the fan turn on / turn off error fix contributed by @naoki-mizuno (#92). It further improves fan handling in two ways: - Adds a toggle in `FAN_CLASS` configuration page to enable or disable the `OSCILLATE` feature for fans that do not support oscillation. - Skips applying speed on `async_turn_on` when the `SET_SPEED` feature is not supported, preventing errors for unsupported devices. ### Why Some fan models do not have oscillation support, and swing was previously always enabled, which expose the unsupported oscillation switch button. Also, turn on … Excerpt saved from GitHub on 2026-10-23. | PR #93 · 2026-06 | |
| Sony TV via SwitchBot IR remote | Partly works Cloud | Power, volume, mute work; learned custom buttons fail with 'No this command'Saved copyI do have custom/learned buttons for Sony TV in the Switchbot app and they work there just fine. In the SwitchBot Remote IR integration the basic commands like Tun ON/OFF, Volume Up/Down and Mute work as well, however, none of the learned/custom commands work and the following error message is displayed whenever I press any of the custom buttons: "Failed to call service button/press. An error occurred: No this command". The commands do have exactly the same names as in the Switchbot app. Attaching the config details as well as log excerpt. Excerpt saved from GitHub on 2026-10-23. | Issue #44 · 2024-03 | |
| SwitchBot IR air conditioner | Partly works Cloud | Partly in Home Climate shows in Home; current temperature missing without a sensor | Works as DIY device; actual room temperature sensor not yet supportedSaved copyYou can do it via official switchbot integration. Excerpt saved from GitHub on 2026-10-23. | Issue #2 · 2023-07 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Cloud push
Goes through the maker’s cloud, which sends updates as they happen. Needs the internet and an account.
Details
| Installs (analytics) | 512 (0.07%) |
|---|---|
| GitHub stars | 100 |
| Latest version | 1.3.7 (2026-06-19) |
| Set up in the UI | Yes |
| Maintainers | @KiraPC, @joshepw |
| License | MIT |
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
Sources
- Documentation: https://github.com/KiraPC/ha-switchbot-remote#readme
- Source code: https://github.com/KiraPC/ha-switchbot-remote
- Issues: https://github.com/KiraPC/ha-switchbot-remote/issues
- HACS: https://hacs.xyz