rship-govee

rship executor for controlling Govee smart home devices. Bridges rship with Govee's API for remote device control including lights, switches, and other smart home products.

Quickstart

• Get your Govee API key from the Govee Developer Portal
• Setup and run rship-govee

git clone https://github.com/ignition-is-go/rship-govee
cd rship-govee
cp docker-compose.override.yml.example docker-compose.override.yml
# Edit docker-compose.override.yml with your API key and rship server details
docker-compose up

Development

cargo fmt --all
cargo clippy --all-targets --all-features -- -D warnings -A unused-variables -A dead-code
cargo test
cargo build --release

Configuration

Environment variables:

• GOVEE_API_KEY: Your Govee API key (required)
• RSHIP_ADDRESS: rship server address (default: nyc.rship.io)
• RSHIP_PORT: rship server port (default: 5155)
• RUST_LOG: Log level (default: info)

rship

Device-Level Actions

• turn: Turn device on/off (value: "on" or "off")
• brightness: Set brightness level (value: 1-100)
• color: Set device color (r, g, b: 0-255)
• color-tem: Set color temperature (value: device-specific range in Kelvin)

Device-Level Emitters

• online: Device online status (value: true/false)
• power-state: Current power state (value: "on" or "off")
• brightness: Current brightness level (value: 1-100)
• color: Current color (r, g, b: 0-255)
• color-tem: Current color temperature (value: Kelvin)

Dependencies

• rship-sdk: rship integration framework
• reqwest: HTTP client for Govee API
• serde: Serialization/deserialization

License

This project follows the same licensing as the rship ecosystem.