{"id":13438942,"url":"https://github.com/Hummer12007/brightnessctl","last_synced_at":"2025-03-20T06:31:55.616Z","repository":{"id":41117589,"uuid":"54909281","full_name":"Hummer12007/brightnessctl","owner":"Hummer12007","description":"A program to read and control device brightness","archived":false,"fork":false,"pushed_at":"2024-12-10T10:31:10.000Z","size":118,"stargazers_count":935,"open_issues_count":31,"forks_count":52,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-12-10T11:31:09.439Z","etag":null,"topics":["backlight","brightness","linux","wayland"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Hummer12007.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":"2016-03-28T17:16:43.000Z","updated_at":"2024-12-10T10:31:14.000Z","dependencies_parsed_at":"2024-02-04T13:47:42.908Z","dependency_job_id":"a6ab23de-ec56-4b62-a900-9c183b979fd5","html_url":"https://github.com/Hummer12007/brightnessctl","commit_stats":{"total_commits":120,"total_committers":25,"mean_commits":4.8,"dds":0.3916666666666667,"last_synced_commit":"3152968fee82796e5d3bac3b49d81e1dd9787850"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hummer12007%2Fbrightnessctl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hummer12007%2Fbrightnessctl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hummer12007%2Fbrightnessctl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hummer12007%2Fbrightnessctl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Hummer12007","download_url":"https://codeload.github.com/Hummer12007/brightnessctl/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244565800,"owners_count":20473353,"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":["backlight","brightness","linux","wayland"],"created_at":"2024-07-31T03:01:09.837Z","updated_at":"2025-03-20T06:31:50.606Z","avatar_url":"https://github.com/Hummer12007.png","language":"C","funding_links":[],"categories":["C","TODO","Brightness Control","Installation","\u003ca name=\"system\"\u003e\u003c/a\u003eSystem tools"],"sub_categories":["Required Dependencies","Program List"],"readme":"# brightnessctl\n\nThis program allows you read and control device brightness on Linux. Devices, by default, include backlight and LEDs (searched for in corresponding classes). If omitted, the first found device is selected.\n\nIt can also preserve current brightness before applying the operation (allowing for usecases like disabling backlight on lid close).\n\n## Installation\n\nThe program is available in:\n* [Alpine Linux](https://pkgs.alpinelinux.org/packages?name=brightnessctl\u0026branch=edge)\n* [Arch Linux](https://www.archlinux.org/packages/extra/x86_64/brightnessctl/)\n* [Void Linux](https://github.com/void-linux/void-packages/blob/master/srcpkgs/brightnessctl/template)\n* [Debian](https://packages.debian.org/testing/source/brightnessctl) - starting with Buster (and derivatives)\n* [Ubuntu](https://packages.ubuntu.com/search?suite=all\u0026searchon=names\u0026keywords=brightnessctl) - starting with 18.04 (and derivatives)\n* [openSUSE](https://build.opensuse.org/package/show/utilities/brightnessctl) - available in Tumbleweed, use OBS `utilities/brightnessctl` devel project for Leap \u003c 15.1\n* [Fedora](https://src.fedoraproject.org/rpms/brightnessctl) - available in Fedora 31+\n* [NixOS/nix](https://search.nixos.org/packages?type=packages\u0026query=brightnessctl) - starting with 17.09, please see the [NixOS Wiki page](https://nixos.wiki/wiki/Backlight#brightnessctl) for the \"best-practice\" configuration file based installation\n\nOne can build and install the program using `./configure \u0026\u0026 make install`. Consult `./configure --help` for relevant build-time options.\n\n## Permissions\n\nModifying brightness requires write permissions for device files or systemd support. `brightnessctl` accomplishes this (without using `sudo`/`su`/etc.) by either of the following means:\n\n1) installing relevant udev rules to add permissions to backlight class devices for users in `video` and leds for users in `input`. (done by default)\n\n2) installing `brightnessctl` as a suid binary.\n\n3) using the `systemd-logind` API.\n\n## FAQ\n\n#### I'd like to configure the brightness of an external monitor\n\nUse the [ddcci-driver-linux](https://gitlab.com/ddcci-driver-linux/ddcci-driver-linux) kernel module to expose external monitor brightness controls to `brightnessctl`. Available in repositories of [AUR](https://aur.archlinux.org/packages/ddcci-driver-linux-dkms/), [Debian](https://packages.debian.org/stable/ddcci-dkms), [Nix](https://github.com/NixOS/nixpkgs/blob/master/pkgs/os-specific/linux/ddcci/default.nix), [Ubuntu](https://packages.ubuntu.com/search?suite=all\u0026searchon=names\u0026keywords=ddcci-dkms), [Void](https://github.com/void-linux/void-packages/tree/master/srcpkgs/ddcci-dkms).\n\n## Usage\n```\nUsage: brightnessctl [options] [operation] [value]\n\nOptions:\n  -l, --list\t\t\tlist devices with available brightness controls.\n  -q, --quiet\t\t\tsuppress output.\n  -p, --pretend\t\t\tdo not perform write operations.\n  -m, --machine-readable\tproduce machine-readable output.\n  -n, --min-value\t\tset minimum brightness, defaults to 1.\n  -e, --exponent[=K]\t\tchanges percentage curve to exponential.\n  -s, --save\t\t\tsave previous state in a temporary file.\n  -r, --restore\t\t\trestore previous saved state.\n  -h, --help\t\t\tprint this help.\n  -d, --device=DEVICE\t\tspecify device name (can be a wildcard).\n  -c, --class=CLASS\t\tspecify device class.\n  -V, --version\t\t\tprint version and exit.\n\nOperations:\n  i, info\t\t\tget device info.\n  g, get\t\t\tget current brightness of the device.\n  m, max\t\t\tget maximum brightness of the device.\n  s, set VALUE\t\t\tset brightness of the device.\n\nValid values:\n  specific value\t\tExample: 500\n  percentage value\t\tExample: 50%\n  specific delta\t\tExample: 50- or +10\n  percentage delta\t\tExample: 50%- or +10%\n ```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FHummer12007%2Fbrightnessctl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FHummer12007%2Fbrightnessctl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FHummer12007%2Fbrightnessctl/lists"}