purple-hue

Change a hue light's color based on air quality data from purple air.

Rust

Installation

Cargo

cargo install purple-hue

ArchLinux

purple-hue is in the AUR.

Configuration

In order to run purple-hue, you need to configure a sensor, light and register a user.

You can find the sensor id from the purple air map. The light id is available through these instructions. Finally, you can register a user via purple-hue register-user. Save all of these in a purple-hue.toml file either at /etc/purple-hue.toml, ./purple-hue.toml or $XDG_CONFIG/purple-hue.toml. An example configuration follows. light_id = 1 sensor_id = 1 user_id = "user-id"

Instead of providing a sensor_id, you can also set a sensor_ip if you are able to access the http api of a given sensor.

Systemd

This repository has a systemd unit and timer that can be used to run this as a systemd service every minute.

Release

The following instructions are for deploying updates to this repository to crates.io and to the Arch User Repository.

  1. Identify the new tag version you'll use for the Release
  2. Update the pkgver variable in the PKGBUILD
  3. Update the version in Cargo.toml
    1. Create a new git tag and push it to the origin repository.
  4. cargo publish