🌿🎮 Home Assistant integration for Nature Remo 🎮🌿

---

📢 FORK INFORMATION

This repository is a fork of @0xAHA's fork, which in turn is based on @yutoyazaki's original integration. Many thanks to both authors for their work.
The 0xAHA fork introduced the Home Assistant GUI configuration method and a configurable sensor refresh period. This fork is maintained by @gomablur.

Note: This integration is maintained on a best-effort basis. Issues and pull requests are welcome, but support for all Nature Remo devices cannot be guaranteed.

---

Yet another Home Assistant component for Nature Remo.

⚠️ This integration is neither Nature Remo official nor Home Assistant official. Use at your own risk. ⚠️

✨ Supported features ✨

• Air Conditioner
  • Set mode (e.g. cool, warm, blow etc.)
  • Set temperature
  • Set fan mode
  • Set swing mode
  • Show current temperature
  • Remember previous target temperatures when switching modes back and forth
• Energy Sensor (Nature Remo E/E Lite)
  • Fetch current power usage
• Built-in sensors
  • Temperature
  • Humidity
  • Illuminance
  • Motion (Remo 3) — exposed as a "last motion detected" timestamp
• Light
  • Turn on / off
  • Brightness slider for lights with full-brightness / night buttons (≥90% sends on-100, ≤20% sends night, otherwise on restores the light's own previous setting) — works from HomeKit bridges too
  • Other remote buttons (night mode, favorite, bright-up/down etc.) and learned custom signals exposed as light effects
• TV
  • Power (IR toggle)
  • Volume up / down / mute
  • Channel up / down (as next/previous track)
  • Input source select (Terrestrial / BS / CS)
• Switch

Sensor entities are created based on what each device actually reports, so sensor-less devices such as the Remo nano are also supported (for appliance control).

Tested on Home Assistant Core 2025.5.1 with Nature Remo 3 and Remo nano

🚀 Installation 🚀

HACS (Recommended)

1. Install HACS
2. Add this repository as a custom repository in HACS
3. Install "Nature Remo" from the HACS store
4. Restart Home Assistant

Manual Install

1. Download this repository
2. Create custom_components/nature_remo folder at your config directory
3. Copy files into it

{path_to_your_config}
├── configuration.yaml
└── custom_components
    └── nature_remo
        ├── __init__.py
        ├── config_flow.py
        ├── climate.py
        ├── light.py
        ├── media_player.py
        ├── manifest.json
        ├── sensor.py
        ├── const.py
        └── translations
            └── en.json

⚙️ Configuration ⚙️

UI Configuration (Recommended)

1. Go to https://home.nature.global and sign in/up
2. Generate access token
3. In Home Assistant, go to Configuration → Integrations
4. Click the "+ Add Integration" button
5. Search for "Nature Remo"
6. Enter your access token
7. Click Submit

External temperature sensor (optional)

Devices like the Remo nano have no built-in temperature sensor, so their AC (thermostat) shows no current temperature — HomeKit bridges then display a meaningless 21°C placeholder. You can link any Home Assistant temperature sensor (a BLE thermometer, another room's Remo, a webhook-fed sensor etc.) as the AC's current temperature:

1. Go to Settings → Devices & Services → Nature Remo → Configure
2. Select the air conditioner
3. Pick a temperature sensor (leave empty to go back to the built-in sensor)

The linked sensor's reading is reported as the climate entity's current temperature, including through HomeKit bridges. Fahrenheit sensors are converted to Celsius automatically.

YAML Configuration (Legacy)

⚠️ Note: YAML configuration is deprecated. Please use the UI configuration method instead.

If you have existing YAML configuration, it will be automatically imported. You will see a persistent notification suggesting to remove the following YAML configuration from your configuration.yaml.

# Example of legacy YAML configuration (not recommended)
nature_remo:
  access_token: YOUR_ACCESS_TOKEN

🔧 Troubleshooting 🔧

If you encounter any issues:

1. Check that your access token is correct
2. Ensure your Nature Remo device is online
3. Check the Home Assistant logs for any error messages
4. Try restarting Home Assistant

🤝 Contributing 🤝

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License 📄

This project is licensed under the MIT License - see the LICENSE file for details.