https://github.com/timoa/ha-remi
Home Assistant UrbanHello Remi integration
https://github.com/timoa/ha-remi
Last synced: 4 months ago
JSON representation
Home Assistant UrbanHello Remi integration
- Host: GitHub
- URL: https://github.com/timoa/ha-remi
- Owner: timoa
- License: mit
- Created: 2026-02-19T20:07:35.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-02T09:46:47.000Z (4 months ago)
- Last Synced: 2026-03-02T11:53:58.727Z (4 months ago)
- Language: Python
- Size: 126 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Home Assistant Remi Integration
> **Unofficial** Home Assistant integration for the [UrbanHello Remi](https://www.urbanhello.com/) smart alarm clock.
[](https://github.com/hacs/integration)
This is a community-maintained integration and is **not affiliated with or endorsed by UrbanHello**.
---
## Features
- **Sensors**: Room temperature, ambient luminosity, WiFi signal strength, firmware version, IP address, current face
- **Binary Sensors**: Online status, alive status, firmware update available
- **Select**: Clock face (Off / Awake / Sleepy / Semi-Awake / Smiley), clock format (12h / 24h), music mode
- **Number**: Volume, brightness, noise alert threshold
- **Switch**: Per-alarm enable/disable toggles (one switch per alarm)
- **Lights**: Night light (RGB), background color (RGB)
- **Alarm CRUD**: Create, update and delete alarms via HA services
---
## Requirements
- Home Assistant 2024.1 or newer
- An UrbanHello account (username + password from the Remi app)
---
## Installation
### Via HACS (recommended)
1. Open HACS in Home Assistant
2. Go to **Integrations** → **⋮** → **Custom repositories**
3. Add `https://github.com/timoa/ha-remi` as an **Integration**
4. Search for **Remi** and install it
5. Restart Home Assistant
### Manual
1. Copy the `custom_components/urbanhello_remi_unofficial/` folder into your HA `config/custom_components/` directory
2. Restart Home Assistant
---
## Configuration
1. Go to **Settings → Integrations → Add Integration**
2. Search for **Remi**
3. Enter your UrbanHello account **username** and **password**
4. The integration will authenticate and discover your Remi device automatically
---
## Entities
| Entity | Type | Description |
|--------|------|-------------|
| Temperature | Sensor | Room temperature (°C) |
| Luminosity | Sensor | Ambient light level (lx) |
| WiFi Signal | Sensor | RSSI in dBm |
| Firmware Version | Sensor | Current firmware version |
| IP Address | Sensor | Local IP address |
| Current Face | Sensor | Active face name |
| Online | Binary Sensor | Device online status |
| Alive | Binary Sensor | Device alive status |
| Firmware Update Available | Binary Sensor | Whether a firmware update is available |
| Clock Face | Select | Change the displayed face |
| Clock Format | Select | 12h or 24h format |
| Music Mode | Select | Off / Music / White Noise |
| Volume | Number | Speaker volume (0–100) |
| Brightness | Number | Brightness (0–100) |
| Noise Alert Threshold | Number | Noise notification threshold (0–100) |
| Night Light | Light | RGB night light color |
| Background Color | Light | RGB background LED color |
| Alarm (per alarm) | Switch | Enable/disable individual alarms |
---
## Alarm Services
Alarms are managed via HA services (callable from automations or Developer Tools → Services).
### `remi.create_alarm`
| Field | Required | Description |
|-------|----------|-------------|
| `name` | ✅ | Alarm label |
| `time` | ✅ | ISO 8601 datetime (e.g. `2026-02-20T07:00:00.000Z`) |
| `enabled` | — | Active/inactive (default: `true`) |
| `repeat` | — | Days to repeat: `[0=Sun, 1=Mon, …, 6=Sat]` |
| `face_define` | — | Face at alarm time (e.g. `FACE_DAY`) |
| `volume` | — | Volume override (0–100) |
### `remi.update_alarm`
Same fields as `create_alarm`, plus `event_id` (required) — the `objectId` of the alarm to update.
### `remi.delete_alarm`
| Field | Required | Description |
|-------|----------|-------------|
| `event_id` | ✅ | The `objectId` of the alarm to delete |
---
## Credits
This integration was inspired by [Remi_UrbanHello_hass](https://github.com/pdruart/Remi_UrbanHello_hass) by [@pdruart](https://github.com/pdruart), which provided valuable insights into the alarm toggle functionality and brightness control.
---
## Disclaimer
This integration uses the official UrbanHello cloud API. It may break if UrbanHello changes their API. Use at your own risk.
## License
MIT