{"id":13674802,"url":"https://github.com/philippnormann/xrandr-brightness-script","last_synced_at":"2026-03-10T18:43:34.653Z","repository":{"id":134377706,"uuid":"82217973","full_name":"philippnormann/xrandr-brightness-script","owner":"philippnormann","description":"🔆 Script for adjusting the brightness and color temperature of displays on a software level using xrandr.","archived":false,"fork":false,"pushed_at":"2020-09-30T08:32:07.000Z","size":32,"stargazers_count":111,"open_issues_count":1,"forks_count":22,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-11-11T14:42:58.402Z","etag":null,"topics":["brightness","color-temperature","linux","oled","shell-script","utility","xrandr"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/philippnormann.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":"2017-02-16T19:29:57.000Z","updated_at":"2024-11-07T07:44:27.000Z","dependencies_parsed_at":null,"dependency_job_id":"69ffe821-9661-4fd8-82c6-2a351620dee2","html_url":"https://github.com/philippnormann/xrandr-brightness-script","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philippnormann%2Fxrandr-brightness-script","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philippnormann%2Fxrandr-brightness-script/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philippnormann%2Fxrandr-brightness-script/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philippnormann%2Fxrandr-brightness-script/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/philippnormann","download_url":"https://codeload.github.com/philippnormann/xrandr-brightness-script/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251330416,"owners_count":21572283,"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":["brightness","color-temperature","linux","oled","shell-script","utility","xrandr"],"created_at":"2024-08-02T11:01:02.095Z","updated_at":"2026-03-10T18:43:34.605Z","avatar_url":"https://github.com/philippnormann.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# xrandr-brightness-script\nUtility script for adjusting the brightness and color temperatures of displays using xrandr.\n\nEspecially useful for OLED screens that don't have adjustable hardware backlights.\n\nI recommend binding this script to custom keyboard shortcuts for easy accessibility.\n\n## Usage:\n\nYou can run `brightness.sh` to get a usage description and identify connected displays.\n\n```\n$ ./brightness.sh\nUsage: brightness.sh op display [stepsize|value] [--temp]\n\narguments:\n  op:             - to decrease or + to increase brightness\n                  = to set brightness to a specific value\n  display:        name of a connected display to adjust\n  stepsize:       size of adjustment step (default 0.1)\n  value:          value to set (default 1.0 for brightness, 0.6 for color temperature)\n  --temp:         adjusts color temperature instead of brightness\n\ndisplays:\n  eDP1     brightness:  1.0  gamma:  1.0:1.0:1.0  temp:  0.6\n  DVI-D-0  brightness:  1.0  gamma:  1.0:1.0:1.0  temp:  0.6\n  HDMI-0   brightness:  1.0  gamma:  1.0:1.0:1.0  temp:  0.6\n```\n\n**Note**: Color temperatures range from 0.0 (*warm*) to 1.0 (*cold*) and represent Kelvin values between 3000K and 10000K\n\n### Examples:\n\n```\n$ ./brightness.sh + eDP1               Increase brightness of eDP1 display by 0.1\n$ ./brightness.sh - eDP1               Decrease brightness of eDP1 display by 0.1\n\n$ ./brightness.sh + eDP1 --temp        Increase color temperature of eDP1 display by 0.1\n$ ./brightness.sh - eDP1 --temp        Decrease color temperature of eDP1 display by 0.1\n\n$ ./brightness.sh + eDP1 0.2           Increase brightness of eDP1 display by 0.2\n$ ./brightness.sh - eDP1 0.2           Decrease brightness of eDP1 display by 0.2\n\n$ ./brightness.sh + eDP1 0.2 --temp    Increase color temperature of eDP1 display by 0.2\n$ ./brightness.sh - eDP1 0.2 --temp    Decrease color temperature of eDP1 display by 0.2\n\n$ ./brightness.sh = eDP1               Reset brightness of eDP1 display to 1.0\n$ ./brightness.sh = eDP1 0.5           Set brightness of eDP1 display to 0.5\n\n$ ./brightness.sh = eDP1 --temp        Reset color temperature of eDP1 display to 0.6\n$ ./brightness.sh = eDP1 0.4 --temp    Set color temperature of eDP1 display to 0.4\n```\n## Motivation:\n\nMy motivation for creating this little script was a problem my friend was having with his new HP Spectre x360 OLED using Linux.\nHe wasn't able to adjust the display brightness via the designated brightness keys on his keyboard. \nSo I wrote this script for him and thought maybe others with similar problems could profit from me publishing this.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphilippnormann%2Fxrandr-brightness-script","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphilippnormann%2Fxrandr-brightness-script","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphilippnormann%2Fxrandr-brightness-script/lists"}