{"id":16195274,"url":"https://github.com/tethik/backlight","last_synced_at":"2026-04-15T18:01:41.541Z","repository":{"id":57604013,"uuid":"181232858","full_name":"Tethik/backlight","owner":"Tethik","description":"Program to manipulate screen brightness on Linux using sysfs","archived":false,"fork":false,"pushed_at":"2025-12-22T20:41:22.000Z","size":24,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-12-24T09:50:42.956Z","etag":null,"topics":["linux","linux-desktop-app"],"latest_commit_sha":null,"homepage":null,"language":"Go","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/Tethik.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,"zenodo":null}},"created_at":"2019-04-13T21:59:06.000Z","updated_at":"2025-12-22T20:28:30.000Z","dependencies_parsed_at":"2022-09-04T10:31:48.948Z","dependency_job_id":"d7b9e66e-1fce-4b16-8b95-9b6c02f4d80c","html_url":"https://github.com/Tethik/backlight","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/Tethik/backlight","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tethik%2Fbacklight","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tethik%2Fbacklight/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tethik%2Fbacklight/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tethik%2Fbacklight/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Tethik","download_url":"https://codeload.github.com/Tethik/backlight/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tethik%2Fbacklight/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31853279,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"ssl_error","status_checked_at":"2026-04-15T15:24:39.138Z","response_time":63,"last_error":"SSL_read: 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":["linux","linux-desktop-app"],"created_at":"2024-10-10T08:26:55.237Z","updated_at":"2026-04-15T18:01:41.536Z","avatar_url":"https://github.com/Tethik.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌚 backlight 🌝\n\nProgram to manipulate screen brightness on Linux using sysfs.\n\n```\nbacklight. Simple program to control your backlights.\n\nUsage:\n\tbacklight ls                    Lists all devices and their values\n\tbacklight set \u003cdevice\u003e \u003cval\u003e    Sets the brightness of a device to a specific value\n\tbacklight dec \u003cdevice\u003e \u003cval\u003e    Decreases the brightness of a device by a specific value\n\tbacklight inc \u003cdevice\u003e \u003cval\u003e    Increases the brightness of a device by a specific value\n\tbacklight help\t\t\t\t\tDisplays this help message :)\n```\n\n## Required Permissions\n\nThis program requires the `cap_dac_override` capability to modify brightness values in sysfs without running as root.\n\nAfter installation, you **must** run:\n```bash\nsudo setcap cap_dac_override+ep /path/to/backlight\n```\n\nThe program will warn you if this capability is not set when you try to modify brightness.\n\n## Install\n\nFor x64 you can download and install the released binary with the following script.\n\n```bash\nwget https://github.com/Tethik/backlight/releases/latest/download/backlight\nwget https://github.com/Tethik/backlight/releases/latest/download/backlight-completion.sh\nchmod +x backlight\nsudo mv backlight /usr/local/bin/backlight\nsudo setcap cap_dac_override+ep /usr/local/bin/backlight\nsudo mv backlight-completion.sh /etc/bash_completion.d/backlight\n```\n\n### Build from source\n\nRequires that you have golang installed.\n\n```\ngit clone https://github.com/Tethik/backlight\nmake\nsudo make install\n```\n\n_Why sudo?_ To allow the program access to sysfs from a normal user the install script sets `cap_dac_override`.\n\n### i3 configuration\n\nI originally built this for my own i3 setup. The following is the configuration I use to\nbind the brightness keys on my laptop to run this backlight program.\n\n```\n# Sreen brightness controls\nbindsym XF86MonBrightnessUp exec backlight inc intel_backlight 50\nbindsym XF86MonBrightnessDown exec backlight dec intel_backlight 50\n```\n\n### Nix install\n\n```bash\nnix profile add github:Tethik/backlight\n```\n\n**Important:** After installation, set the required capability:\n```bash\nsudo setcap cap_dac_override+ep $(readlink -f $(which backlight))\n```\n\nThis allows the program to modify sysfs brightness values without requiring sudo for each use.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftethik%2Fbacklight","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftethik%2Fbacklight","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftethik%2Fbacklight/lists"}