{"id":13586676,"url":"https://github.com/smartHomeHub/SmartIR","last_synced_at":"2025-04-07T18:34:28.473Z","repository":{"id":37470587,"uuid":"171121354","full_name":"smartHomeHub/SmartIR","owner":"smartHomeHub","description":"Home Assistant integration to manage climate systems, TVs, fans and lights using IR/RF controllers. Compatible with Broadlink, Xiaomi, MQTT, LOOKin and ESPHome","archived":false,"fork":false,"pushed_at":"2025-02-02T20:02:47.000Z","size":10708,"stargazers_count":2209,"open_issues_count":93,"forks_count":1056,"subscribers_count":50,"default_branch":"master","last_synced_at":"2025-04-02T18:05:16.154Z","etag":null,"topics":["broadlink","chuangmiir","esphome","homeassistant","iot","lookin","smarthome"],"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/smartHomeHub.png","metadata":{"files":{"readme":"docs/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":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":["https://www.buymeacoffee.com/vassilis"]}},"created_at":"2019-02-17T12:48:40.000Z","updated_at":"2025-04-01T17:40:16.000Z","dependencies_parsed_at":"2024-11-06T05:32:18.080Z","dependency_job_id":"2df402b8-ac06-4c4d-aad6-40f7519a74cc","html_url":"https://github.com/smartHomeHub/SmartIR","commit_stats":{"total_commits":1031,"total_committers":253,"mean_commits":4.075098814229249,"dds":0.6663433559650824,"last_synced_commit":"217dfd0e7a6d3a751802931fb85add8e4ccad2ef"},"previous_names":[],"tags_count":40,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smartHomeHub%2FSmartIR","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smartHomeHub%2FSmartIR/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smartHomeHub%2FSmartIR/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smartHomeHub%2FSmartIR/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/smartHomeHub","download_url":"https://codeload.github.com/smartHomeHub/SmartIR/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247707747,"owners_count":20982841,"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":["broadlink","chuangmiir","esphome","homeassistant","iot","lookin","smarthome"],"created_at":"2024-08-01T15:05:44.084Z","updated_at":"2025-04-07T18:34:28.466Z","avatar_url":"https://github.com/smartHomeHub.png","language":"Python","funding_links":["https://www.buymeacoffee.com/vassilis"],"categories":["Custom Components","Install from Source","Python","Custom Integrations"],"sub_categories":["Alternative Dashboards","Smart Home Automation","Custom Lovelace UI Cards"],"readme":"[![](https://img.shields.io/github/v/release/smartHomeHub/SmartIR.svg?style=flat-square)](https://github.com/smartHomeHub/SmartIR/releases/latest) [![](https://img.shields.io/badge/HACS-Custom-orange.svg?style=flat-square)](https://github.com/custom-components/hacs)\n\n\u003e ### ⚠️ Warning  \n\u003e You are free to fork, modify, and use the code in this repository in accordance with the applicable open-source license.  \n\u003e  \n\u003e **However, the name \"SmartIR\" must not be used in any capacity**, especially for promoting, rebranding, or distributing your own fork or derivative works.  \n\u003e  \n\u003e Please respect this guideline to preserve the original project's identity.\n\n## Overview\nSmartIR is a custom integration for controlling **climate devices**, **media players**, **fans** and **lights** via infrared controllers.\u003cbr\u003e\nSmartIR currently supports the following controllers:\n* [Broadlink](https://www.home-assistant.io/integrations/broadlink/)\n* [Xiaomi IR Remote (ChuangmiIr)](https://www.home-assistant.io/integrations/remote.xiaomi_miio/)\n* [LOOK.in Remote](http://look-in.club/devices/remote)\n* [ESPHome User-defined service for remote transmitter](https://esphome.io/components/api.html#user-defined-services)\n* [MQTT Publish service](https://www.home-assistant.io/docs/mqtt/service/)\n\nMore than 120 climate devices are currently supported out-of-the-box, mainly for the Broadlink controller, thanks to our awesome community.\u003cbr\u003e\u003cbr\u003e\nDon't forget to **star** the repository if you had fun!\u003cbr\u003e\u003cbr\u003e\n\n\n## Installation\n### *Manual*\n**(1)** Place the `custom_components` folder in your configuration directory (or add its contents to an existing `custom_components` folder).\nIt should look similar to this:\n```\n\u003cconfig directory\u003e/\n|-- custom_components/\n|   |-- smartir/\n|       |-- __init__.py\n|       |-- climate.py\n|       |-- fan.py\n|       |-- light.py\n|       |-- media_player.py\n|       |-- etc...\n```\n**(2)** Add the following to your configuration.yaml file.\n```yaml\nsmartir:\n```\n\nSmartIR automatically detects updates after each HA startup and asks you to install them. It also has a mechanism that prevents you from updating if the last SmartIR version is incompatible with your HA instance. You can disable this feature by setting SmartIR as follows:\n```yaml\nsmartir:\n  check_updates: false\n```\n\nIf you would like to get updates from the rc branch (Release Candidate), configure SmartIR as follows:\n```yaml\nsmartir:\n  update_branch: rc\n```\n\n**(3)** Configure a platform.\n\n### *HACS*\nIf you want HACS to handle installation and updates, add SmartIR as a [custom repository](https://hacs.xyz/docs/faq/custom_repositories/). In this case, it is recommended that you turn off automatic updates, as above.\n\u003cbr\u003e\u003cbr\u003e\n\n\n## Platform setup instructions\nClick on the links below for instructions on how to configure each platform.\n* [Climate platform](/docs/CLIMATE.md)\n* [Media Player platform](/docs/MEDIA_PLAYER.md)\n* [Fan platform](/docs/FAN.md)\n* [Light platform](/docs/LIGHT.md)\n\u003cbr\u003e\u003cbr\u003e\n\n## See also\n* [Discussion about SmartIR Climate (Home Assistant Community)](https://community.home-assistant.io/t/smartir-control-your-climate-tv-and-fan-devices-via-ir-rf-controllers/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FsmartHomeHub%2FSmartIR","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FsmartHomeHub%2FSmartIR","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FsmartHomeHub%2FSmartIR/lists"}