Skip to content
thevrusPublic

About

Control Logitech Litra Beam LX, Beam and Glow lights from the Mac menu bar or CLI. USB or Bluetooth, no G HUB. Brightness, temperature, back-light colours, auto day/night. Rust + Tauri.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

11 Commits

Folders and files

Repository files navigation

Glint

A small Mac app for Logitech Litra lights.
USB or Bluetooth, straight from the menu bar. No G HUB.

Simple view: a switch between the front and back light, one big brightness slider and a row of colour temperatures Back light tab: a colour for each of the seven zones, or Match Screen and animated effects from the menu Auto tab: the light follows the time of day

Why

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.

Features

  • 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 glint binary 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.

Install

  1. Download Glint.dmg.
  2. Open it and drag Glint onto the Applications folder.
  3. 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 glint

Needs 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.

Command line

cargo install --path core
glint                      # 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

Supported 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.

Troubleshooting

"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 dev

To 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 page 0xff43.
  • Feature indexes differ between USB and Bluetooth firmware, so they are looked up at connect time through IRoot.GetFeature. Illumination is feature 0x1990; back light power and brightness is 0x8040.
  • A back colour report carries up to four zones (zone, r, g, b, with 0xff marking 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 0x0c documented by litra-rs, which works on the Beam LX.

Disclaimer

An independent project, not affiliated with or endorsed by Logitech. Litra and G HUB are trademarks of Logitech.

About

Control Logitech Litra Beam LX, Beam and Glow lights from the Mac menu bar or CLI. USB or Bluetooth, no G HUB. Brightness, temperature, back-light colours, auto day/night. Rust + Tauri.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages