https://github.com/kharyam/litra-driver
Linux CLI and UI for operating Logitech Litra Glow and Beam
https://github.com/kharyam/litra-driver
python
Last synced: about 1 year ago
JSON representation
Linux CLI and UI for operating Logitech Litra Glow and Beam
- Host: GitHub
- URL: https://github.com/kharyam/litra-driver
- Owner: kharyam
- License: gpl-3.0
- Created: 2022-02-02T04:04:30.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-02-27T05:46:54.000Z (over 2 years ago)
- Last Synced: 2024-09-19T11:39:09.626Z (almost 2 years ago)
- Topics: python
- Language: Python
- Homepage: https://pypi.org/project/litra-driver/
- Size: 1.1 MB
- Stars: 133
- Watchers: 3
- Forks: 17
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Python Utility for Logitech Litra Glow and Beam
[](https://badge.fury.io/py/litra-driver)
## UPDATE
I'm working on a port to Go. Follow progress and try the initial version [here](https://github.com/kharyam/go-litra-driver).
## Introduction
After purchasing a [Logitech Litra Glow](https://www.logitech.com/en-us/products/lighting/litra-glow.946-000001.html) I was unable to find any support for linux. This project reverse-engineers the basic functionality of the litra glow so that we can control it via USB without using the physical buttons on the device. It also now supports the [Logitech Litra Beam](https://www.logitech.com/en-us/products/lighting/litra-beam.946-000006.html).
## Quick Start
### Linux
```bash
# If necessary, create a udev role to grant permission to access the light
sudo tee /etc/udev/rules.d/82-litra-glow.rules <<< 'SUBSYSTEM=="usb", ATTR{idVendor}=="046d", ATTR{idProduct}=="c900",MODE="0666"'
sudo tee /etc/udev/rules.d/82-litra-beam.rules <<< 'SUBSYSTEM=="usb", ATTR{idVendor}=="046d", ATTR{idProduct}=="c901",MODE="0666"'
# For most operating systems, reloading udev rules is enough
sudo udevadm control --reload-rules
sudo udevadm trigger
# For others, a reboot may be required
# sudo reboot
# Uninstall if previously installed
pip uninstall litra-driver
pip install litra-driver
# Command Line Interface
lc --help
# User Interface
lcui
```
#### Fedora Dependencies
The following dependencies may need to be installed for the UI. This was specifically noted on Fedora 37:
```bash
sudo dnf install -y python3-tkinter libappindicator-gtk3
```
#### Ubuntu Dependencies
The following dependencies may need to be installed for the UI. This was specifically noted on ubuntu 20.04:
```bash
sudo apt-get install -y python3-tk gir1.2-appindicator3-0.1
```
## The UI
A basic UI can be launched to allow control of the light:
```bash
lcui
```
## The CLI
```
NAME
lc
SYNOPSIS
lc COMMAND
COMMANDS
COMMAND is one of the following:
on
Turns on the Litra Glow
off
Turns off the Litra Glow
temp
Sets the temperature level of the Litra Glow
bright
Sets the brightness level of the Litra Glow
```
Sample Usage
```bash
lc on
lc bright 10
lc temp 6500
lc off
# Chain multiple commands
lc on bright 100 temp 2700
```
The log level can be adjusted by setting the environment variable `LITRA_LOGLEVEL` to one of the following:
* CRITICAL
* ERROR
* WARNING
* INFO
* DEBUG
## Development
### Creating / installing the distribution
```bash
pip install build
# Create distribution
python -m build
# Local Testing
pip install --editable .
# Linter
tox -e lint
# Unit Test - "Coming Soon"™
tox -e test
# Push to pypi
pip install twine
twine check dist/*
twine upload dist/*
```