Skip to content
BranchesTags
 
 

Repository files navigation

litra-rs

💡 Control Logitech Litra lights from the command line, Model Context Protocol (MCP) clients and Rust applications

Fork notice. This repository is a personal fork of timrogers/litra-rs. It tracks upstream but adds two GUI front-ends on top of the library and CLI:

Everything else in this README reflects upstream behavior. The fork may lag behind upstream; for the canonical project see the upstream repo. See CLAUDE.md for a full list of fork changes.

Features

With this tool, you can:

  • 💡 Turn your light on and off
  • 👀 Check if the light is on or off
  • 🎛️ Set, get, increase and decrease the brightness of your light
  • 🌡️ Set, get, increase and decrease the temperature of your light
  • 🌈 Control the colorful back side of the Litra Beam LX, turning it on and off, setting the brightness and switching colors

Tip

🖲️ Want to automatically turn your Litra on and off when your webcam turns on and off? Check out litra-autotoggle!

Supported devices

The following Logitech Litra devices, connected via USB, are supported:

Installation

macOS or Linux via Homebrew

  1. Install the latest version by running brew install litra.
  2. Run litra --help to check that everything is working and see the available commands.

Note

If you installed Litra via Homebrew before January 30 2026, you will have installed from the timrogers/homebrew-tap tap. litra is now available through homebrew-core. You should reinstall the tool by running brew uninstall litra && brew install litra.

macOS, Linux or Windows via Cargo, Rust's package manager

  1. Install Rust on your machine, if it isn't already installed.
  2. Install the litra crate by running cargo install litra.
  3. Run litra --help to check that everything is working and see the available commands.

macOS, Linux or Windows via direct binary download

  1. Download the latest release for your platform. macOS, Linux and Windows devices are supported.
  2. Add the binary to $PATH, so you can execute it from your shell. For the best experience, call it litra on macOS and Linux, and litra.exe on Windows.
  3. Run litra --help to check that everything is working and see the available commands.

Configuring udev permissions on Linux

On most Linux operating systems, you will need to manually configure permissions using udev to allow non-root users to access and manage Litra devices.

To allow all users that are part of the video group to access the Litra devices, copy the 99-litra.rules file into /etc/udev/rules.d. Next, reboot your computer or run the following commands as root:

# udevadm control --reload-rules
# udevadm trigger

Usage

From the command line

The following commands are available for controlling your devices:

  • litra on: Turn your Logitech Litra device on
  • litra off: Turn your Logitech Litra device off
  • litra toggle: Toggles your Logitech Litra device on or off
  • litra brightness: Sets the brightness of your Logitech Litra device, using either --value (measured in lumens) or --percentage (as a percentage of the device's maximum brightness). The brightness can be set to any value between the minimum and maximum for the device returned by the devices command.
  • litra brightness-up: Increases the brightness of your Logitech Litra device, using either --value (measured in lumens) or --percentage (with a number of percentage points to add to the device's brightness)
  • litra brightness-down: Decreases the brightness of your Logitech Litra device, using either --value (measured in lumens) or --percentage (with a number of percentage points to subtract from the device's brightness)
  • litra temperature: Sets the temperature of your Logitech Litra device, using a --value measured in kelvin (K). The temperature can be set to any multiple of 100 between the minimum and maximum for the device returned by the devices command.
  • litra temperature-up: Increases the temperature of your Logitech Litra device, using a --value measured in kelvin (K). The value must be a multiple of 100.
  • litra temperature-down: Decreases the temperature of your Logitech Litra device, using a --value measured in kelvin (K). The value must be a multiple of 100.
  • litra back-on: Turn on the colorful backlight on your Logitech Litra Beam LX device
  • litra back-off: Turn off the colorful backlight on your Logitech Litra Beam LX device
  • litra back-toggle: Toggles the colorful backlight on your Logitech Litra Beam LX device on or off
  • litra back-brightness: Sets the brightness of the colorful backlight on your Logitech Litra Beam LX device, using --percentage (as a percentage of the maximum brightness)
  • litra back-brightness-up: Increases the brightness of the colorful backlight on your Logitech Litra Beam LX device, using --percentage (with a number of percentage points to add to the backlight's brightness)
  • litra back-brightness-down: Decreases the brightness of the colorful backlight on your Logitech Litra Beam LX device, using --percentage (with a number of percentage points to subtract from the backlight's brightness)
  • litra back-color: Sets the color of the colorful backlight on your Logitech Litra Beam LX device, using --color (a named color) or --value (a hexadecimal color code, e.g. FF0000 for red). You can optionally target a specific zone with --zone (numbered 1 to 7 from left to right).

By default, these commands target all connected Litra devices, but this can be filtered down using one of the following device targeting options:

  • --serial-number/-s: Specify the device to target by its serial number
  • --device-path/-p: Specify the device path to target (useful when devices don't have serial numbers)
  • --device-type/-t: Specify the type of device to target: glow, beam, or beam_lx (not available for back-* commands which only support Litra Beam LX devices)

The following commands are also included:

  • litra devices: List Logitech Litra devices connected to your computer. This will be returned in human-readable format by default, or you can get JSON output with the --json flag.

Each CLI command can also be called with --help for more detailed documentation.

Automatic update check

The CLI automatically checks for updates once per day. If a new version is found, it will print details on how to upgrade.

You can disable this behavior by setting the LITRA_DISABLE_UPDATE_CHECK environment variable.

From a Model Context Protocol (MCP) client

Running the litra mcp command starts a local Model Context Protocol (MCP) server, exposing tools to allow you to control your Litra devices from AI applications and agents.

Usage with Claude Desktop

To use the MCP server with Claude Desktop:

  1. From the Claude app, open the "Developer" menu, then click "Open App Config File...".
  2. Add the MCP server to the mcpServers key in your config:
{
  "mcpServers": {
    "litra": {
      "command": "litra",
      "args": [
        "mcp"
      ]
    }
  }
}
  1. Back in the Claude app, open the "Developer" menu, then click "Reload MCP Configuration".
  2. To check that the MCP server is running, start a chat, then click the "Search and tools" button under the chat input, and check for a "litra" item in the menu.

Available Tools

The following tools are available:

  • litra_devices: List available Logitech Litra devices
  • litra_on: Turn your Logitech Litra device on
  • litra_off: Turn your Logitech Litra device off
  • litra_toggle: Toggles your Logitech Litra device on or off
  • litra_brightness: Sets the brightness of your Logitech Litra device to either a specific value measured in lumens (lm) or a percentage of the device's maximum brightness. The brightness can be set to any value between the minimum and maximum for the device returned by the litra_devices tool.
  • litra_brightness_up: Increases the brightness of your Logitech Litra device, using either a specific value (measured in lumens) or a percentage of the device's maximum brightness
  • litra_brightness_down: Decreases the brightness of your Logitech Litra device, using either a specific value (measured in lumens) or a percentage of the device's maximum brightness
  • litra_temperature: Sets the temperature of your Logitech Litra device to a specific value measured in kelvin (K). The temperature can be set to any multiple of 100 between the minimum and maximum for the device returned by the litra_devices tool.
  • litra_temperature_up: Increases the temperature of your Logitech Litra device, using a specific value measured in kelvin (K). The value must be a multiple of 100.
  • litra_temperature_down: Decreases the temperature of your Logitech Litra device, using a specific measured in kelvin (K). The value must be a multiple of 100.
  • litra_back_on: Turn on the back light on your Logitech Litra Beam LX device
  • litra_back_off: Turn off the back light on your Logitech Litra Beam LX device
  • litra_back_toggle: Toggles the back light on your Logitech Litra Beam LX device on or off
  • litra_back_brightness: Sets the brightness of the back light on your Logitech Litra Beam LX device to a specific percentage of the maximum brightness
  • litra_back_brightness_up: Increases the brightness of the back light on your Logitech Litra Beam LX device by a specified number of percentage points
  • litra_back_brightness_down: Decreases the brightness of the back light on your Logitech Litra Beam LX device by a specified number of percentage points
  • litra_back_color: Sets the color of the back light on your Logitech Litra Beam LX device to a specific hexadecimal color code. Can target a specific zone (1-7) or all zones.

Via GUI applications

macOS Menubar Application

A native macOS menubar application provides quick access to your Litra devices from the system menu bar.

Features:

  • System tray icon with click-to-show popup window
  • Device selection from multiple connected Litra devices
  • Real-time power, brightness, and temperature controls
  • Positioned popup window below the menubar icon

Building and running:

# Build the menubar application
cargo build --bin litra-menubar --features menubar --release

# Run from the build directory
./target/release/litra-menubar

For easier access, you can optionally create a macOS .app bundle to add to your Applications folder or run at login.

KDE Plasma Plasmoid (Linux)

A native KDE Plasma 6 plasmoid (QML widget) lives in tray-plasmoid/. It plugs into the panel or system tray, gets popup positioning for free from Plasma, and shells out to the litra CLI.

Features:

  • Native Plasma 6 system tray integration with proper popup anchoring
  • Real-time brightness and temperature control via litra
  • Custom lightbulb icon (lit when on, outline when off)

Install (Arch via the bundled PKGBUILD):

makepkg -si    # builds litra CLI + udev rule + installs plasmoid system-wide

Then add the widget: right-click panel/system tray > Add or Manage Widgets > search Litra Glow Control.

Manual install (development / non-Arch):

cd tray-plasmoid && ./install.sh
kquitapp6 plasmashell && (setsid plasmashell &) >/dev/null 2>&1

From a Rust application

The litra crate includes functions for interacting with Litra devices from your Rust applications.

To see the full API, check out the documentation on Docs.rs or read through src/lib.rs.

About

💡 Control your Logitech Litra light from the command line

Resources

Readme
License
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages