A Homebridge plugin for Pura smart fragrance diffusers.

This plugin is intentionally simple. It exposes a single on/off switch per diffuser, allowing you to control each device using HomeKit.

It’s designed to be used with Pura’s auto-away and scheduling features disabled, so HomeKit can act as the primary automation layer.

Supported Diffusers

This plugin is designed and tested for the following diffusers.

Installation

1. Install this plugin using: npm install -g @qandnotu/homebridge-pura
2. Edit your config.json file (see sample config below)
3. Run Homebridge

Configuration

Add the following platform to your config.json:

{
  "platforms": [
    {
      "name": "Pura Smart Diffuser",
      "platform": "PuraSmartDiffuser",
      "username": "[email protected]",
      "password": "your-pura-password",
      "forceNightlightOff": false
    }
  ]
}

Configuration Options

• username: Your Pura app username (email address) - required
• password: Your Pura app password - required
• forceNightlightOff: By default, Pura turns the nightlight on/off with the diffuser. Enable this to force the nightlight off after the diffuser turns on (default: false)

Features

• Multiple Device Support: Automatically discovers all Pura devices on your account
• Simple On/Off Control: One switch per diffuser for HomeKit automations
• Real-Time Status: Uses realtime updates with a 5-minute polling fallback (15s when realtime is down)

Usage

Once configured, your Pura diffusers will appear in the Home app as a single switch per diffuser (e.g., "Living Room Diffuser").

Controls

• Power: Turn the diffuser on/off

Device Management

The plugin will automatically:

• Discover all Pura devices on your account
• Create one switch per diffuser
• Update device status via realtime updates with a 5-minute polling fallback (15s when realtime is down)
• Handle authentication and token refresh (including periodic Cognito refresh polling)

Recommended Usage

• Use this plugin in lieu of Pura schedules or auto-away.
• Enable Auto-Alternative Fragrances in the Pura app for best results.
• By default, Pura turns the nightlight on/off with the diffuser. If you want to prevent the light from staying on, enable forceNightlightOff.

Troubleshooting

Authentication Issues

If you encounter authentication errors:

1. Verify your username and password are correct
2. Check that your Pura account is active and can log in to the mobile app
3. Ensure your internet connection is stable

Device Not Appearing

If your Pura device doesn't appear in HomeKit:

1. Check that the device is online and connected to WiFi
2. Verify it appears in the Pura mobile app
3. Check Homebridge logs for error messages
4. Try restarting Homebridge

Connectivity Issues

If the plugin loses connection:

1. Check your internet connection
2. Verify Pura services are operational
3. Try restarting the plugin by restarting Homebridge

Support

For issues and feature requests, please use the GitHub Issues page.

Credits

This plugin is inspired by and based on the pypura Python library by @natekspencer.

License

Apache-2.0