Homebridge Pura
A Homebridge plugin for Pura smart fragrance diffusers.
This plugin allows you to control your Pura smart fragrance diffusers through Apple HomeKit. Each fragrance bay on your Pura device will appear as a separate fan in the Home app, where you can:
- Turn the diffuser on/off
- Adjust the fragrance intensity (0-100%)
- Monitor the current state of your diffusers
Installation
- Install this plugin using:
npm install -g homebridge-pura
- Edit your
config.json file (see sample config below)
- Run Homebridge
Configuration
Add the following platform to your config.json:
{
"platforms": [
{
"name": "Pura Fragrance Diffuser",
"platform": "PuraFragranceDiffuser",
"username": "your-pura-email@example.com",
"password": "your-pura-password",
"refreshInterval": 300
}
]
}
Configuration Options
- username: Your Pura app username (email address) - required
- password: Your Pura app password - required
- refreshInterval: How often to refresh device status in seconds (default: 300, min: 30, max: 3600)
Features
- Multiple Device Support: Automatically discovers all Pura devices on your account
- Bay-Level Control: Each fragrance bay appears as a separate fan accessory
- Intensity Control: Use the fan speed slider to adjust fragrance intensity
- Real-Time Status: Automatically refreshes device status
- HomeKit Integration: Full integration with Apple HomeKit and the Home app
Usage
Once configured, your Pura diffusers will appear in the Home app as fans. Each fragrance bay will be a separate accessory (e.g., "Living Room Pura Bay 1", "Living Room Pura Bay 2").
Controls
- Power: Turn the diffuser on/off
- Fan Speed: Adjust the fragrance intensity (0-100%)
Device Management
The plugin will automatically:
- Discover all Pura devices on your account
- Create accessories for each fragrance bay
- Update device status based on the configured refresh interval
- Handle authentication and token refresh
Troubleshooting
Authentication Issues
If you encounter authentication errors:
- Verify your username and password are correct
- Check that your Pura account is active and can log in to the mobile app
- Ensure your internet connection is stable
Device Not Appearing
If your Pura device doesn't appear in HomeKit:
- Check that the device is online and connected to WiFi
- Verify it appears in the Pura mobile app
- Check Homebridge logs for error messages
- Try restarting Homebridge
Connectivity Issues
If the plugin loses connection:
- Check your internet connection
- Verify Pura services are operational
- Try restarting the plugin by restarting Homebridge
Support
For issues and feature requests, please use the GitHub Issues page.
Development
Release Process
This project uses automated releases via GitHub Actions. To create a new release:
- Update the version in
package.json
- Commit your changes:
git commit -am "Release v1.x.x"
- Create and push a version tag:
git tag v1.x.x && git push origin v1.x.x
The GitHub Actions workflow will automatically:
- Build and test the code
- Create a GitHub release
- Publish the package to npm
Note: Make sure the version in package.json matches the tag version (without the 'v' prefix). The workflow will verify this and fail if they don't match.
Prerequisites for Publishing
To publish releases, repository maintainers need to configure:
NPM_TOKEN: A valid npm authentication token with publish permissions
Credits
This plugin is inspired by and based on the pypura Python library by @natekspencer.
License
Apache-2.0
