{"id":17716346,"url":"https://github.com/kharyam/litra-driver","last_synced_at":"2025-04-07T17:08:29.432Z","repository":{"id":38063924,"uuid":"454637737","full_name":"kharyam/litra-driver","owner":"kharyam","description":"Linux CLI and UI for operating Logitech Litra Glow and Beam","archived":false,"fork":false,"pushed_at":"2024-02-27T05:46:54.000Z","size":1154,"stargazers_count":133,"open_issues_count":11,"forks_count":17,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-09-19T11:39:09.626Z","etag":null,"topics":["python"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/litra-driver/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kharyam.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-02-02T04:04:30.000Z","updated_at":"2024-09-16T15:06:25.000Z","dependencies_parsed_at":"2024-02-27T06:46:30.949Z","dependency_job_id":null,"html_url":"https://github.com/kharyam/litra-driver","commit_stats":{"total_commits":35,"total_committers":7,"mean_commits":5.0,"dds":0.4571428571428572,"last_synced_commit":"5547d0c49a4fc441ceb40fc8414c9d406d53f56c"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kharyam%2Flitra-driver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kharyam%2Flitra-driver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kharyam%2Flitra-driver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kharyam%2Flitra-driver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kharyam","download_url":"https://codeload.github.com/kharyam/litra-driver/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247694876,"owners_count":20980733,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["python"],"created_at":"2024-10-25T13:11:51.224Z","updated_at":"2025-04-07T17:08:29.407Z","avatar_url":"https://github.com/kharyam.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Python Utility for Logitech Litra Glow and Beam\n[![PyPI version](https://badge.fury.io/py/litra-driver.svg?unused=0.8.0)](https://badge.fury.io/py/litra-driver)\n\n## UPDATE\n\nI'm working on a port to Go.  Follow progress and try the initial version [here](https://github.com/kharyam/go-litra-driver).\n\n## Introduction\n\nAfter 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).\n\n## Quick Start\n\n### Linux\n```bash\n# If necessary, create a udev role to grant permission to access the light\nsudo tee /etc/udev/rules.d/82-litra-glow.rules \u003c\u003c\u003c 'SUBSYSTEM==\"usb\", ATTR{idVendor}==\"046d\", ATTR{idProduct}==\"c900\",MODE=\"0666\"'\nsudo tee /etc/udev/rules.d/82-litra-beam.rules \u003c\u003c\u003c 'SUBSYSTEM==\"usb\", ATTR{idVendor}==\"046d\", ATTR{idProduct}==\"c901\",MODE=\"0666\"'\n\n# For most operating systems, reloading udev rules is enough\nsudo udevadm control --reload-rules\nsudo udevadm trigger\n\n# For others, a reboot may be required\n# sudo reboot\n\n# Uninstall if previously installed\npip uninstall litra-driver\npip install litra-driver\n\n# Command Line Interface\nlc --help\n\n# User Interface\nlcui\n\n```\n\n#### Fedora Dependencies\n\nThe following dependencies may need to be installed for the UI. This was specifically noted on Fedora 37:\n\n```bash\nsudo dnf install -y python3-tkinter libappindicator-gtk3\n```\n\n#### Ubuntu Dependencies\n\nThe following dependencies may need to be installed for the UI. This was specifically noted on ubuntu 20.04:\n\n```bash\nsudo apt-get install -y python3-tk gir1.2-appindicator3-0.1\n```\n\n## The UI\nA basic UI can be launched to allow control of the light:\n\n```bash\nlcui\n```\n\n![lcui Screen Shot](images/ui.png)\n## The CLI\n\n```\nNAME\n    lc\n\nSYNOPSIS\n    lc COMMAND\n\nCOMMANDS\n    COMMAND is one of the following:\n\n     on\n       Turns on the Litra Glow\n\n     off\n       Turns off the Litra Glow\n\n     temp\n       Sets the temperature level of the Litra Glow\n\n     bright\n       Sets the brightness level of the Litra Glow\n```\n\nSample Usage\n```bash\nlc on\nlc bright 10\nlc temp 6500\nlc off\n\n# Chain multiple commands\nlc on bright 100 temp 2700\n```\n\nThe log level can be adjusted by setting the environment variable `LITRA_LOGLEVEL` to one of the following:\n* CRITICAL\n* ERROR\n* WARNING\n* INFO\n* DEBUG\n\n## Development\n### Creating / installing the distribution\n\n```bash\npip install build\n\n# Create distribution\npython -m build\n\n# Local Testing\npip install --editable .\n\n# Linter\ntox -e lint\n\n# Unit Test - \"Coming Soon\"™\ntox -e test\n\n# Push to pypi \npip install twine\ntwine check dist/*\ntwine upload dist/*\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkharyam%2Flitra-driver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkharyam%2Flitra-driver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkharyam%2Flitra-driver/lists"}