2025.12.5
Home ▸ Integrations ▸

Rituals Perfume Genie

The Rituals Perfume Genie integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to control and monitor your Rituals perfume diffusers connected to your Rituals account.

Use cases

  • Monitor current device state.
  • Control fragrance diffusion and amount.
  • Expose cartridge level, type and room configuration.

Supported devices

  • Rituals Perfume Genie
  • Rituals Perfume Genie 2nd Generation
  • Rituals Perfume Genie 3rd Generation

Configuration

To add the Rituals Perfume Genie integration to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Rituals Perfume Genie.

  • Follow the instructions on screen to complete the setup.

Email

The email address used to register your Rituals Perfume Genie.

Password

The password used to register your Rituals Perfume Genie.

Supported functionality

The integration will fetch data from each device. Below is a complete overview of the entities this integration provides.

Important

Some entities are only available on the battery powered model.

Binary Sensor

  • Charging state

Number

  • Perfume amount

Select

  • Room size

Sensor

  • Battery percentage
  • Fill level
  • Perfume label
  • WiFi signal

Switch

  • Fan

Examples

The following examples show how to use the Rituals Perfume Genie integration in Home Assistant automations. These examples are just a starting point, and you can use them as inspiration to create your own automations.

Turn the Perfume Genie on at a specific time

The following example will turn on the Perfume Genie at 18:00.

automation:
  - alias: "Start fragrance in evening"
    triggers:
      - trigger: time
        at: "18:00:00"

    actions:
      - action: switch.turn_on
        target:
          entity_id: switch.rituals_perfume_genie_diffuser

Removing the integration

This integration follows standard integration removal, no extra steps are required.

To remove an integration instance from Home Assistant

  1. Go to Settings > Devices & services and select the integration card.
  2. From the list of devices, select the integration instance you want to remove.
  3. Next to the entry, select the three dots menu. Then, select Delete.