https://github.com/madsmtm/menhue
Status bar interface for Phillips Hue lights
https://github.com/madsmtm/menhue
macos objc2 rust rust-lang
Last synced: 19 days ago
JSON representation
Status bar interface for Phillips Hue lights
- Host: GitHub
- URL: https://github.com/madsmtm/menhue
- Owner: madsmtm
- Created: 2024-08-29T18:12:01.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-02-03T06:21:16.000Z (3 months ago)
- Last Synced: 2025-03-24T00:38:06.480Z (about 1 month ago)
- Topics: macos, objc2, rust, rust-lang
- Language: Rust
- Homepage:
- Size: 42 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Menhue - Status bar interface for Phillips Hue lights
Mostly an open-source clone of https://huemenu.app/, but without the (IMO) excessive polling it does to always be up to date. Starting a request on click is enough to feel interactive.
Very feature-incomplete and work-in-progress, don't actually use this for anything other than inspiration for how to use [`objc2`](https://docs.rs/objc2/).
## Design decisions
Uses only Cocoa APIs, to get a feel for what that's like.
In a real-world application, I'd strongly recommend `serde` and `serde_json` for interacting with JSON data, and `reqwest` for doing the URL requests.
## Future ideas
- Integrate with `AppIntents`, and support Siri, automations, and so on.
- Actually, maybe let the automations be written in Automator itself, and then parse those, and send them to the lamp in a fashion it understands?
- Maybe all of this can be done by integrating with `HomeKit`?
- `SensorKit` for ambient light?
- Or: https://stackoverflow.com/questions/17625495/how-do-you-programmatically-access-the-ambient-light-sensor-on-mac-os-x-10-5
- https://github.com/insidegui/DarkModeBuddy
- Use https://developer.apple.com/documentation/systemconfiguration/1514895-scnetworkreachabilitycreatewitha?language=objc (or the equivalent from the Network framework)
- See also https://developer.apple.com/documentation/widgetkit?language=objc
## Notes
Detecting `mouseEntered:`/`mouseExited:` for status bar buttons is not possible, even with replacing the class.
Old API docs: https://developers.meethue.com/develop/hue-api/, https://www.burgestrand.se/hue-api/
Developer: https://$HOST/debug/clip.html
## State machine WIP
```mermaid
flowchart TD;
Init-->DataFromCache;
DataFromCache[Getting data from cache...]
DataFromCache-- Failure -->LoginDialog;
DataFromCache-- Success -->MenuReady;
LoginDialog[[Show login dialog]]
LoginDialog-- Log in with details -->FetchUser;
FetchUser[Logging in...]
FetchUser-- Failure -->LoginDialog;
FetchUser-- Success -->MenuReady;
MenuReady[[Menu ready]]
MenuReady-- On open -->FetchLampStatus;
FetchLampStatus[Fetching lamp status...]
FetchLampStatus-- Permission error -->LoginDialog2;
LoginDialog2[[Show login dialog]]
FetchLampStatus-- Failure -->MenuOpenWithError;
FetchLampStatus-- Success -->MenuOpen;
MenuOpenWithError[[Show error in menu]]
MenuOpenWithError-- Retry -->FetchLampStatus;
MenuOpenWithError-- Close -->MenuReady;
MenuOpen[[Show lamps]]
MenuOpen-- Edit Lamp -->EditLamp;
MenuOpen-- Close -->MenuReady;
EditLamp[Editing lamp...]
EditLamp-- Permission error -->LoginDialog3;
LoginDialog3[[Show login dialog]]
EditLamp-- Failure -->MenuOpenWithError;
EditLamp-- Success -->MenuOpen;
```
## Nix
```nix
# darwin-configuration.nix
{
imports = [ menhue/service.nix ];
services.menhue = {
enable = true;
host = "...";
username = "...";
};
}
```