Appliances & cleaning

Rituals Perfume Genie

rituals_perfume_genie

Built inCloud polling

The Rituals Perfume Genie integration lets you control and monitor your Rituals perfume diffusers from Home Assistant.

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
`switch`	Switch or outlet
`binary_sensor`	Sensor (motion, contact, leak, smoke…)
`select`	Mode picker (as switches)

What people report

All Perfume Genie generations are documented as working via the Rituals cloud. Genie 3.0 users report it being shown as 2.0 with a dead fill sensor.

Works2
Partly works1

Device	In Home Assistant	What they said	Source
Rituals Perfume Genie	Works Cloud	Controlled via Rituals cloud; battery entities on battery model only Saved copy Supported devices: Rituals Perfume Genie; Rituals Perfume Genie 2nd generation; Rituals Perfume Genie 3rd generation. Limitations: The integration relies on the Rituals cloud service. If your internet connection or the Rituals service is unavailable, Home Assistant cannot read from or control your diffuser. The battery and charging entities are available on the battery-powered model only. Excerpt saved from home-assistant.io on 2026-10-23.	Docs
Rituals Perfume Genie 2nd generation	Works Cloud	Controlled via Rituals cloud Saved copy Supported devices: Rituals Perfume Genie; Rituals Perfume Genie 2nd generation; Rituals Perfume Genie 3rd generation. Limitations: The integration relies on the Rituals cloud service. If your internet connection or the Rituals service is unavailable, Home Assistant cannot read from or control your diffuser. The battery and charging entities are available on the battery-powered model only. Excerpt saved from home-assistant.io on 2026-10-23.	Docs
Rituals Perfume Genie 3.0	Partly works Cloud	Identified as model 2.0; cartridge fill sensor always unknown Saved copy The problem My Rituals Perfume Genie 3.0 is incorrectly identified as model "2.0" in the device info, even after updating to Home Assistant Core 2026.6.3 (which includes #173552 fixing the sw_version dict issue). In addition, the "Fill" sensor entity (cartridge fill level) is present but always shows no value / unknown state. The "Perfume" sensor (cartridge type / fragrance name) does work correctly and shows the right value. This might be related to the device being misidentified as a 2.0 hub, since fill-level reporting could differ between the 2.0 and 3.0 hardware/API response. ### What … Excerpt saved from GitHub on 2026-10-23.	Issue #173780 · 2026-06

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 polling

Goes through the maker’s cloud, asking it for updates every so often. Needs the internet and an account.

Details

Installs (analytics)	578 (0.08%)
Added in	Home Assistant 2021.3
Set up in the UI	Yes
Maintainers	@milanmeu, @frenck, @quebulm

Devices listed in its documentation

Rituals Perfume Genie
Rituals Perfume Genie 2nd generation
Rituals Perfume Genie 3rd generation

Limitations from the docs

The integration relies on the Rituals cloud service. If your internet connection or the Rituals service is unavailable, Home Assistant cannot read from or control your diffuser.
The battery and charging entities are available on the battery-powered model only.

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.