{"id":17268109,"url":"https://github.com/waydabber/betterdisplaycli","last_synced_at":"2026-03-06T20:31:55.849Z","repository":{"id":221372770,"uuid":"754191856","full_name":"waydabber/betterdisplaycli","owner":"waydabber","description":"Simple CLI access for BetterDisplay","archived":false,"fork":false,"pushed_at":"2024-11-28T06:08:24.000Z","size":32,"stargazers_count":40,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-18T14:03:54.538Z","etag":null,"topics":["betterdisplay","cli","command","display","integration","line","macos","management","notification","swift"],"latest_commit_sha":null,"homepage":"https://betterdisplay.pro","language":"Swift","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/waydabber.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":"2024-02-07T15:22:57.000Z","updated_at":"2025-03-17T07:33:30.000Z","dependencies_parsed_at":"2024-06-28T23:31:26.962Z","dependency_job_id":"3a886824-9daa-4be1-bd8e-13fd07de70a4","html_url":"https://github.com/waydabber/betterdisplaycli","commit_stats":null,"previous_names":["waydabber/betterdisplaycli"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waydabber%2Fbetterdisplaycli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waydabber%2Fbetterdisplaycli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waydabber%2Fbetterdisplaycli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waydabber%2Fbetterdisplaycli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/waydabber","download_url":"https://codeload.github.com/waydabber/betterdisplaycli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245003641,"owners_count":20545641,"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":["betterdisplay","cli","command","display","integration","line","macos","management","notification","swift"],"created_at":"2024-10-15T08:12:32.477Z","updated_at":"2025-03-22T18:34:30.024Z","avatar_url":"https://github.com/waydabber.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# betterdisplaycli\n\nA simple command line app to interact with [BetterDisplay](https://betterdisplay.pro).\n\nBetterDisplay must be running and configured to accept CLI commands (this is the default setting).\n\n## Installation and usage\n\n### Prerequisites\n\n- [BetterDisplay](https://betterdisplay.pro) v2.2.0 or later must be installed.\n\n### Installation\n\n#### Method 1 - Direct download\n\n1. **Download the compiled, signed, notarized, universal binary version:\n   [betterdisplaycli-v1.0.1.zip](https://github.com/waydabber/betterdisplaycli/releases/download/v1.0.1/betterdisplaycli-v1.0.1.zip)**\n1. Optionally move the downloaded binary to its permanent location (recommended: `/usr/local/bin`).\n\n#### Method 2 -  Automated compile and installation using Homebrew\n\n1. Install [XCode](https://developer.apple.com/xcode).\n1. Enter `brew install waydabber/betterdisplay/betterdisplaycli`\n\n#### Method 3 -  Manual compile and installation from source\n\n1. Install [XCode](https://developer.apple.com/xcode).\n2. Download source package `git clone https://github.com/waydabber/betterdisplaycli`\n3. Enter the downloaded folder: `cd ./betterdisplaycli`\n4. Enter `sudo make install`. This will compile the app and install it under `/usr/local/bin`.\n\n... or instead of the last step you can continue like this:\n\n5. Compile by entering: `swiftc betterdisplaycli.swift`\n6. Move the compiled `betterdisplaycli` binary to a location where it's easily available in `$PATH`.\n\n### Usage\n\n1. Make sure BetterDisplay 2.2.x and newer is running and is configured to accept CLI/notification requests.\n1. Run `betterdisplaycli` for help.\n1. Try `betterdisplaycli set --brightness=80%` to set the brightness level of all displays to 80% (note: you can use both single and double hyphen style for parameters).\n\n\u003e [!NOTE]\n\u003e You can use the installed app itself to send CLI commands as well - the following prints help:\n\u003e \n\u003e `/Applications/BetterDisplay.app/Contents/MacOS/BetterDisplay help`\n\n## CLI and integration documentation\n\nMore info and other integration options:\n\n- https://github.com/waydabber/BetterDisplay/wiki/Integration-features,-CLI\n\nThis app also serves as a demonstration of how to integrate your app with BetterDisplay using notification dispatch.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaydabber%2Fbetterdisplaycli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwaydabber%2Fbetterdisplaycli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaydabber%2Fbetterdisplaycli/lists"}