Skip to content

agarpac/litra-native-mac

Repository files navigation

Litra Native

Litra Native is an experimental macOS menu bar utility that turns a Logitech Litra Beam on for an active physical camera and turns it off after the camera session ends. It is a source-visible portfolio project, developed by Alberto Garrido (@agarpac).

Litra Native menu bar showing automation, light status, and controls

Status

Experimental and unsupported. This repository publishes the source code and may provide downloadable application builds. It has not been tested as a general-use product, and hardware behaviour can vary with macOS and device state.

Requirements

  • macOS 14 or later on Apple silicon (arm64)
  • A Logitech Litra Beam accessible to macOS
  • A physical camera available to macOS

Download and install

  1. Download the .zip from the latest public release.
  2. Expand it and move Litra Native.app to /Applications.
  3. Open the app from /Applications.

Release builds are ad-hoc signed and not notarized. If macOS blocks the first launch, open System Settings → Privacy & Security, find the message about Litra Native, and select Open Anyway. Confirm the prompt, then open the app again.

Public availability permits downloading the release but does not grant permission to redistribute it. See LICENSE for the applicable terms.

Authorized maintainer build

Only an authorized maintainer or a person with prior written permission from Alberto Garrido may build the source. This section does not grant a licence to use, copy, or redistribute the repository or resulting application. An authorized source build requires Xcode Command Line Tools.

git clone https://github.com/agarpac/litra-native-mac.git
cd litra-native-mac
swift build
Support/package.sh 0.1.0

The last command creates a local dist/Litra Native-0.1.0.zip.

Use

Open the app, then use a physical camera. The first active camera starts one automation session; the light turns off two seconds after the last camera stops. The menu also provides manual power, brightness, colour-temperature, and automation controls. A manual power action temporarily takes ownership from automation until manual power is turned off.

The interface is currently Spanish (Spain). Launch-at-login is best-effort and should be verified manually after installation.

Architecture and checks

The app is a native Swift package with:

  • camera activity observation through macOS media-device state, without reading frames;
  • an ownership state machine separating automatic and manual light control;
  • a Litra Beam transport built on IOKit HID and HID++; it does not use a BLE or CoreBluetooth implementation;
  • local preferences and no network service.

Run the available checks with:

swift build
swift run LitraDomainSelfTest
swift run LitraHIDSelfTest
swift run LitraCameraSelfTest
swift run LitraRuntimeSelfTest

Privacy and notices

Litra Native runs locally and does not include telemetry, analytics, accounts, or cloud services. It does not capture camera frames, audio, screenshots, meeting metadata, or application names.

This project is not affiliated with, endorsed by, or sponsored by Logitech. Logitech, Litra, and related marks are trademarks of their respective owners. The project includes no Logitech SDK, firmware, or assets; protocol constants are present only for interoperability with the Litra Beam.

License

Copyright © 2026 Alberto Garrido. All rights reserved. See LICENSE.

About

Native macOS menu bar automation for Logitech Litra Beam

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages