{"id":13779959,"url":"https://github.com/sidevesh/Luminance","last_synced_at":"2025-05-11T13:31:15.706Z","repository":{"id":176206153,"uuid":"613245823","full_name":"sidevesh/Luminance","owner":"sidevesh","description":"A simple GTK application to control brightness of displays including external displays supporting DDC/CI","archived":false,"fork":false,"pushed_at":"2024-07-04T10:30:05.000Z","size":689,"stargazers_count":91,"open_issues_count":7,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-08-03T18:14:36.445Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C","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/sidevesh.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":"2023-03-13T07:40:24.000Z","updated_at":"2024-08-03T00:32:45.000Z","dependencies_parsed_at":"2024-01-15T22:42:06.690Z","dependency_job_id":"7033d4a4-88ad-4a01-b936-8a598605d52f","html_url":"https://github.com/sidevesh/Luminance","commit_stats":null,"previous_names":["sidevesh/luminance"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sidevesh%2FLuminance","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sidevesh%2FLuminance/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sidevesh%2FLuminance/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sidevesh%2FLuminance/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sidevesh","download_url":"https://codeload.github.com/sidevesh/Luminance/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225056753,"owners_count":17414202,"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":[],"created_at":"2024-08-03T18:01:10.936Z","updated_at":"2024-11-17T15:30:48.252Z","avatar_url":"https://github.com/sidevesh.png","language":"C","funding_links":[],"categories":["Applications","Brightness Control","System Management"],"sub_categories":["System and Customization","System Configuration"],"readme":"\u003ca name=\"readme-top\"\u003e\u003c/a\u003e\n\n\u003cbr /\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/sidevesh/Luminance\"\u003e\n    \u003cimg src=\"icons/hicolor/scalable/apps/com.sidevesh.Luminance.svg\" alt=\"Logo\" width=\"120\" height=\"120\"\u003e\n  \u003c/a\u003e\n\n\u003ch3 align=\"center\"\u003eLuminance\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    A simple GTK application to control brightness of displays including external displays supporting DDC/CI\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"screenshots/screenshot-faded.png\" alt=\"Screenshot\"\u003e\n\u003c/div\u003e\n\n## Install from AUR (Arch Linux):\n  \n  ```\n  yay -S luminance\n  ```\n\n## Install deb package (Debian and Ubuntu based distros):\nLatest deb release is available on the releases page https://github.com/sidevesh/Luminance/releases\n\n* Version 1.0.4 is the last supported version for Ubuntu before 24.04, Debian or any other Debian based distro that does not have atleast libadwaita 1.5 version\n\n## Install rpm package (Fedora, OpenSUSE and other rpm based distros):\nLatest rpm release is available on the releases page https://github.com/sidevesh/Luminance/releases\n\n## Install from source\n\n### Dependencies\n- GTK 4.0\n- Libadwaita\n- ddcutil library package (typically libddcutil or libddcutil-dev if not already installed with ddcutil)\n\n### Steps\n1. Firstly, ensure that all the dependencies are installed:\n\n    ##### Arch Linux:\n    ```\n    pacman -S --needed glib2 gtk4 libadwaita ddcutil\n    ```\n    \n    ##### Ubuntu-based distros (credit @aidengilmartin):\n    ```\n    sudo apt install gcc libglib2.0-dev libgtk-4-dev libadwaita-1-dev libddcutil-dev\n    ```\n    ##### Fedora:\n    ```\n    sudo dnf install gcc glib2-devel gtk4-devel libadwaita-devel libddcutil-devel\n    ```\n\n2. Ensure that your user has access to the i2c devices:\nhttps://www.ddcutil.com/i2c_permissions/\n\n3. Clone this repo along with its submodules:\n    ```\n    git clone --recurse-submodules https://github.com/sidevesh/Luminance.git\n    ```\n\n4. Change into the `Luminance` directory and execute build.sh to build this application:\n    ```\n    cd Luminance\n    ./build.sh\n    ```\n\n5. This should result in a binary that you can execute to contol the brightness:\n    ```\n    ./build/app\n    ```\n\n6. To install this binary for all users execute 'install.sh' as root:\n    ```\n    sudo ./install.sh\n    ```\n\n    You should now be able to find Luminance in your list of apps\n    * Installing the application is necessary for it to work because it uses gsettings to store preferences and will need the schema files to be installed.\n      You can read the install.sh script and copy the schema files yourself if you don't want to do all the install steps.\n\n\n## Usage\n\nStart the application normally or you can also use the app via cli interface:\n```\nUsage: com.sidevesh.Luminance [OPTIONS]\nAn application to control brightness of displays including external displays supporting DDC/CI\n\nOptions:\n  -l, --list-displays                         List displays and their brightness\n  -g, --get-percentage [DISPLAY NUMBER]       Get the brightness percentage of a display\n  -s, --set-brightness [DISPLAY NUMBER]       Set the brightness of a display to a percentage value\n  -i, --increase-brightness [DISPLAY NUMBER]  Increase the brightness of a display by a percentage value\n  -d, --decrease-brightness [DISPLAY NUMBER]  Decrease the brightness of a display by a percentage value\n                                              If DISPLAY NUMBER is not provided, for --set-brightness, --increase-brightness and --decrease-brightness options, the brightness of all displays will be changed\n  -p  --percentage [PERCENTAGE]               Percentage value to set the brightness to in case of --set-brightness option or to increase or decrease the brightness by in case of --increase-brightness or --decrease-brightness option\n  -o, --show-osd                              Show OSD popup when brightness is changed for specified environment:\n                                                g: GNOME, experimental, only works with https://extensions.gnome.org/extension/5952/eval-gjs/ extension installed\n  -h, --help                                  Show help information\n\nWhen no arguments are provided, the application starts in GUI mode.\n```\n\n## Note for AUR publishers\n\nSwitch the arch submodule push url to the ssh url before pushing to AUR for the first time:\n```\ncd arch\ngit remote set-url --push origin ssh://aur@aur.archlinux.org/luminance.git\n```\n\n\n## License\n\nDistributed under the GNU General Public License v3.0. See `LICENSE.txt` for more information.\n\n\n\n## Contact\n\nSwapnil Devesh - [@sid_devesh](https://twitter.com/sid_devesh) - me@sidevesh.com\n\nProject Link: [https://github.com/sidevesh/Luminance](https://github.com/sidevesh/Luminance)\n\n\n\n## Acknowledgments\n\n- @ahshabbir : for ddcbc-api and ddcbc-gtk: https://github.com/ahshabbir/ddcbc-api\n- @rockowitz : for ddcutil c api: https://github.com/rockowitz/ddcutil\n- @jimmac : for the awesome new icon: https://github.com/jimmac\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsidevesh%2FLuminance","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsidevesh%2FLuminance","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsidevesh%2FLuminance/lists"}