A small Mac app for Logitech Litra lights.
USB or Bluetooth, straight from the menu bar. No G HUB.
To control a Litra Beam LX from a computer, Logitech gives you G HUB: a large app with background services and an account prompt, for a desk light.
I wanted to turn the light on before a call, pick a colour for the back, and have it warm up in the evening. The light speaks the same HID++ protocol as Logitech mice, so this app sends those few commands itself.
- One slider when that's all you need. The simple view is a big brightness slider and a row of colours, with a switch between the front and back light and one button that turns everything off. The detailed view adds everything else.
- Front light. Power, brightness from 30 to 400 lm, temperature from 2700 to 6500 K.
- Back light. Power, brightness, and a colour for each of the 7 zones.
- Match Screen. The back light follows the colours on your display, fading slowly enough that it never pulls your eye.
- Effects. Rainbow, Aurora, Ocean, Ember and Breathe animate the back light.
- Adaptive. Cool and bright by day, warm and dim at night, switching at the two times you pick.
- Presets. Six built in, plus your own.
- Menu bar. Toggle lights and apply presets without opening a window.
- CLI. One
glintbinary for scripts and shortcuts.
It reconnects on its own after sleep or a dropped Bluetooth link. The only network request it makes is a daily check for a new version on GitHub, which you can turn off in the menu bar.
- Download Glint.dmg.
- Open it and drag Glint onto the Applications folder.
- Open Glint from Applications. The first time, macOS says it could not verify the app, because Glint is not registered with Apple yet. Click Done, open System Settings > Privacy & Security, scroll down to the line about Glint and click Open Anyway. You only do this once.
If you use Homebrew, this does all three steps, with no warning to click through:
brew tap thevrus/glint https://github.com/thevrus/glint
brew trust thevrus/glint
brew install --cask glintNeeds macOS 14 or later, on Apple silicon or Intel. Glint updates itself: when a new version is out, the menu bar menu shows Install Glint x.y.z and Restart. Until the app is registered with Apple, macOS asks for Screen Recording permission again after each update if you use Match Screen.
Then connect the light by USB, or pair it in System Settings > Bluetooth, quit G HUB if it is running, and open the app.
cargo install --path coreglint # current state
glint on
glint off
glint brightness 250 # lumens, 30 to 400
glint temp 4400 # kelvin, 2700 to 6500 in steps of 100
glint back-on
glint back-brightness 70 # percent
glint back-color ff5a3c # all zones
glint back-color ff5a3c 3 # zone 3 only, 1 to 7 from the left
glint back-zones ff0000 ff8000 ffff00 00ff00 00ffff 0000ff ff00ff # all seven at once
glint devices # list connected lights| Light | Connection | Status |
|---|---|---|
| Litra Beam LX | Bluetooth, USB | Developed and tested on this |
| Litra Beam | USB, Bluetooth | Recognised, untested |
| Litra Glow | USB | Recognised, untested |
macOS only for now. The code is Tauri and hidapi, so Windows and Linux may build, but nobody has tried.
"Light not connected". Check the light is on and paired, and that G HUB is closed. Over Bluetooth, switching the light off and on usually brings it back.
Brightness or colour jumps back. Adaptive is on. Turn it off in the Auto tab or from the menu bar.
Development
Needs Rust, Node.js 20+ and the Xcode Command Line Tools (xcode-select --install).
cd app
npm install
npm run tauri devTo release, set version in app/src-tauri/Cargo.toml, commit, then push a matching tag (git tag v0.2.0 && git push origin main v0.2.0). The release workflow builds the universal DMG, publishes the signed update, and bumps Casks/glint.rb.
| Path | What |
|---|---|
core/ |
glint-core: the protocol library and the glint CLI. Its only dependency is hidapi. |
app/src-tauri/ |
Tauri backend: device thread, presets, adaptive mode, Match Screen, menu bar. |
app/src/ |
Frontend in plain TypeScript, no framework. |
litra.swift |
The original single-file IOKit prototype, kept for reference. |
Settings and presets live in ~/Library/Application Support/dev.glint.desktop/config.json.
Protocol notes
- Commands are HID++ 2.0 long reports (report ID
0x11, 20 bytes) on the vendor usage page0xff43. - Feature indexes differ between USB and Bluetooth firmware, so they are looked up at connect time through
IRoot.GetFeature. Illumination is feature0x1990; back light power and brightness is0x8040. - A back colour report carries up to four zones (zone, r, g, b, with
0xffmarking an unused slot), and nothing shows until the commit, so all seven zones change together in three reports. - The front light only accepts temperatures in whole hundreds of kelvin; anything between is answered with error
0x02. - The feature ID for back zone colours hasn't been identified. The code uses the fixed index
0x0cdocumented by litra-rs, which works on the Beam LX.
An independent project, not affiliated with or endorsed by Logitech. Litra and G HUB are trademarks of Logitech.


