> For the complete documentation index, see [llms.txt](https://kb.linknlink.com/kb/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.linknlink.com/kb/smart-home-devices/emotion-series/add-ir-for-ha.md).

# Add IR for HA

**Problem** The "Add IR for HA" process gets stuck or fails while "Downloading IR Code Library," preventing you from adding your device.

**Solution** Bypass the download issue by first adding the device to the mobile app, then converting it for Home Assistant.

**Steps**

1. **Add to Mobile App**
   * In your smart home app (e.g., Smart Life), choose **"Add IR for App"**.
   * Follow the guide: select your device brand and **learn all essential IR codes** (Power, Mode, Temp Up/Down, Fan Speed, etc.).
   * **Save** the remote. Confirm you can control the device from the app.
2. **Convert to HA Panel**
   * Go to the device page in the app. Tap the **"..."** menu and select **"Convert to HA Panel"**.
   * Select the device you want to convert and tap **"Convert"**.
   * Return to the main device list, **pull down to refresh**. A new device with an **"HA" tag** will appear.

**Next Step** To control this panel from Home Assistant, complete the setup by configuring it via **MQTT**.
