{"id":48611237,"url":"https://github.com/mora9715/better-backlight","last_synced_at":"2026-04-09T00:34:33.715Z","repository":{"id":272824871,"uuid":"917868060","full_name":"mora9715/better-backlight","owner":"mora9715","description":"Better Backlight aims to improve the keyboard backlight control on Linux systems","archived":false,"fork":false,"pushed_at":"2025-01-31T23:51:52.000Z","size":19,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-01T00:24:26.886Z","etag":null,"topics":["backlight","keyboard","linux","thinkpad"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mora9715.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","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":"2025-01-16T19:48:02.000Z","updated_at":"2025-01-31T23:51:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"3f46a654-2aa2-4ac2-b39a-7d0f958371cf","html_url":"https://github.com/mora9715/better-backlight","commit_stats":null,"previous_names":["mora9715/better-backlight"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/mora9715/better-backlight","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mora9715%2Fbetter-backlight","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mora9715%2Fbetter-backlight/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mora9715%2Fbetter-backlight/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mora9715%2Fbetter-backlight/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mora9715","download_url":"https://codeload.github.com/mora9715/better-backlight/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mora9715%2Fbetter-backlight/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31580187,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T14:31:17.711Z","status":"ssl_error","status_checked_at":"2026-04-08T14:31:17.202Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["backlight","keyboard","linux","thinkpad"],"created_at":"2026-04-09T00:34:33.504Z","updated_at":"2026-04-09T00:34:33.659Z","avatar_url":"https://github.com/mora9715.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Better Backlight\n\nBetter Backlight aims to improve the keyboard backlight control on Linux systems.\n\nIt automatically disables the keyboard backlight after a period of inactivity and restores it when the user interacts\nwith the keyboard.\n\nIt respects user preferences. If the user disabled the keyboard backlight, Better Backlight will not enable it\nautomatically.\nIf the user set a specific brightness level, Better Backlight will not go beyond that level.\n\n## Features\n\n- Automatic keyboard backlight control.\n- Automatic detection of supported backlit keyboard devices.\n\n## How it works\n\nThe service listens to input device events through the `evdev` interface. When user activity is detected, the service\nenables the keyboard backlight through sysfs led management interface.\n\nIf no user activity is detected for a period of time, the service disables the keyboard backlight.\n\n## Installation\n\nThe service is provided as RPM/DEB packages. The latest release can be found in\nthe [Releases](https://github.com/mora9715/better-backlight/releases) page.\n\nTo install the package, run the following command:\n\n### Debian-based systems\n\n```shell\nwget https://github.com/mora9715/better-backlight/releases/latest/download/better-backlight-\u003cversion\u003e.deb\nsudo apt install ./better-backlight-\u003cversion\u003e.rpm\n```\n\n### RedHat-based systems\n\n```shell\nwget https://github.com/mora9715/better-backlight/releases/latest/download/better-backlight-\u003cversion\u003e.rpm\nsudo dnf install ./better-backlight-\u003cversion\u003e.rpm\n```\n\n## Service Management\n\nAfter installing, you can manage the service using `systemctl`:\n\n```bash\nsudo systemctl enable better-backlight   # Enable service at boot\nsudo systemctl start better-backlight    # Start service immediately\nsudo systemctl status better-backlight   # Check current status\n```\n\n## Configuration\n\nThe configuration file is located at `/etc/better-backlight.conf`.\n\n1. Modify the configuration:\n\n```shell\nsudo nano /etc/better-backlight.conf\n```\n\n2. Restart the service:\n\n```shell\nsudo systemctl restart better-backlight\n```\n\nA sample configuration file with detailed descriptions can be found [here](packaging/etc/better-backlight.conf).\n\n## Troubleshooting\n\nIf the service is not working as expected, you can check the logs for more information:\n\n```shell\njournalctl -u better-backlight\n# OR\ntail -f /var/log/better-backlight.log\n```\n\n## TODO List\n\nThe following features are planned for the first stable release:\n\n| Item               | Description                                                              | Status |\n|--------------------|--------------------------------------------------------------------------|:------:|\n| Configuration      | Add configuration file to allow users to customize the behavior          |   ✅    |\n| Debian Packaging   | Configure .deb packages building for easier installation                 |   ✅    |\n| Tests              | Add unit tests to ensure the service works as expected                   |   ✅    |\n| Power Management   | Add ability to keep the backlight enabled when the system is on AC power |   ❌    |\n| Security Hardening | Add SELinux and/or AppArmor policies for enhanced security               |   ❌    |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmora9715%2Fbetter-backlight","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmora9715%2Fbetter-backlight","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmora9715%2Fbetter-backlight/lists"}