{"id":13634456,"url":"https://github.com/alin23/lunar","last_synced_at":"2026-01-30T22:20:21.147Z","repository":{"id":37706451,"uuid":"139616172","full_name":"alin23/Lunar","owner":"alin23","description":"Intelligent adaptive brightness for your external monitors","archived":false,"fork":false,"pushed_at":"2025-05-08T09:04:01.000Z","size":846251,"stargazers_count":5008,"open_issues_count":5,"forks_count":115,"subscribers_count":30,"default_branch":"master","last_synced_at":"2025-05-08T10:20:41.578Z","etag":null,"topics":["adaptive-brightness","brightness","brightness-control","contrast","ddc","ddc-ci","display","macbook","macos","monitor","swift","swiftui","volume-control","xdr"],"latest_commit_sha":null,"homepage":"https://lunar.fyi","language":"Swift","has_issues":false,"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/alin23.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2018-07-03T17:23:54.000Z","updated_at":"2025-05-08T09:49:45.000Z","dependencies_parsed_at":"2023-02-12T16:45:48.108Z","dependency_job_id":"7256fa93-1323-42d5-bd04-1510457c32ab","html_url":"https://github.com/alin23/Lunar","commit_stats":null,"previous_names":[],"tags_count":163,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alin23%2FLunar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alin23%2FLunar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alin23%2FLunar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alin23%2FLunar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alin23","download_url":"https://codeload.github.com/alin23/Lunar/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254028072,"owners_count":22002175,"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":["adaptive-brightness","brightness","brightness-control","contrast","ddc","ddc-ci","display","macbook","macos","monitor","swift","swiftui","volume-control","xdr"],"created_at":"2024-08-01T23:01:05.360Z","updated_at":"2026-01-30T22:20:21.099Z","avatar_url":"https://github.com/alin23.png","language":"Swift","readme":"\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://lunar.fyi/\"\u003e\u003cimg width=\"128\" height=\"128\" src=\"https://static.lunar.fyi/svg/lunar.svg\" style=\"filter: drop-shadow(0px 2px 4px rgba(80, 50, 6, 0.2));\"\u003e\u003c/a\u003e\n  \u003ch1 align=\"center\"\u003e\u003ccode style=\"text-shadow: 0px 3px 10px rgba(8, 0, 6, 0.35); font-size: 3rem; font-family: ui-monospace, Menlo, monospace; font-weight: 800; background: transparent; color: #4d3e56; padding: 0.2rem 0.2rem; border-radius: 6px\"\u003eLunar\u003c/code\u003e\u003c/h1\u003e\n  \u003ch4 align=\"center\" style=\"padding: 0; margin: 0; font-family: ui-monospace, monospace;\"\u003eThe defacto app for controlling monitors\u003c/h4\u003e\n  \u003ch6 align=\"center\" style=\"padding: 0; margin: 0; font-family: ui-monospace, monospace; font-weight: 400;\"\u003eAdjust brightness, change volume, switch inputs\u003c/h6\u003e\n\u003c/p\u003e\n\n#### macOS app for controlling monitors, [with native support for both Intel and Apple Silicon](https://lunar.fyi/#m1)\n\n## Community\n\n[![Support Server](https://img.shields.io/discord/852182428155904010.svg?label=Discord\u0026logo=Discord\u0026colorB=7289da\u0026style=for-the-badge)](https://discord.gg/dJPHpWgAhV)\n\n## DDC/CI\n\nLunar changes the hardware brightness of the monitor using the DDC protocol.\n\nIt doesn't use a software overlay if the monitor supports DDC/CI.\n\n## Installation methods\n- Download [Lunar.dmg](https://lunar.fyi/download/latest) from [lunar.fyi](https://lunar.fyi/)\n- Or `brew install --cask lunar`\n\n## Features\n- **[Native keyboard control](https://lunar.fyi/#keys)** and hotkeys for setting brightness, volume and contrast that respect the min/max values per monitor\n- **[1000-to-1600 nits of brightness](https://lunar.fyi/#xdr)** for supported **XDR** and **HDR** displays\n- **[Dim brightness below 0%](https://lunar.fyi/#subzero)** for late-night work\n- **[Sensor-based Adaptive Brightness](https://lunar.fyi/#sensor)** (and contrast) based on [an external light sensor](https://lunar.fyi/sensor)\n- **[Sync-based Adaptive Brightness](https://lunar.fyi/#sync)** (and contrast) based on **the built-in light sensor of the MacBook or iMac**\n- **[Location-based Adaptive Brightness](https://lunar.fyi/#location)** (and contrast) based on the sunrise/sunset times in your location\n- **[App Presets](https://lunar.fyi/#configuration-page)** if you need more/less brightness for specific activities (watching movies, design work)\n- **[Input switching](#input-hotkeys)** from a convenient dropdown or using up to 3 input-specific hotkeys\n- **[Screen orientation](https://lunar.fyi/#display-settings-page)** change from the menu bar or using hotkeys (Ctrl+0/9/8/7 mapped to 0°/90°/180°/270° for the display with the cursor on it)\n- **[Hidden resolutions](https://lunar.fyi/#display-settings-page)** accessible from a dropdown in the [Display Settings menu](#display-settings)\n- **[BlackOut](https://lunar.fyi/#blackout)**: turn off monitors (or the built-in display) selectively while also keeping important functions:\n    - USB-C charging still works\n    - Monitor audio keeps playing\n    - Monitor USB hub remains available\n    - The built-in keyboard and trackpad are still available for use\n    - Avoid overheating the MacBook because of using it with the lid closed\n\nIt doesn't interfere at all with the native adaptive brightness that macOS implements for the built-in display.\n\nIt works well along Night Shift and True Tone (and f.lux if Gamma dimming is not used).\n\n\n## QuickActions Menu\n\n![QuickActions menu](https://files.lunar.fyi/menu-density-demo.png)\n\n## Display Page\n\n![Display page](https://files.lunar.fyi/display-page.png)\n\n## Display Settings\n\n![Display settings](https://files.lunar.fyi/display-settings.png)\n\n## Built-in Display Page\n\n![Built-in display page](https://files.lunar.fyi/builtin-page.png)\n\n## Display Input Hotkeys\n\n![Display input hotkeys](https://files.lunar.fyi/input-hotkeys.png)\n\n## Configuration Page\n\n![Configuration page](https://files.lunar.fyi/configuration-page.png)\n\n## Hotkeys Page\n\n![Hotkeys page](https://files.lunar.fyi/hotkeys-page.png)\n\n\n## Tested and known to work with the following types of connections\n- HDMI (1.0 - 2.1)\n- DisplayPort (1.0 - 2.0)\n- Thunderbolt 4 (USB Type-C)\n- Thunderbolt 3 (USB Type-C)\n- Thunderbolt 2 (mini DisplayPort)\n- VGA\n- DVI\n- Adapters that forward DDC messages properly\n\n### Contributing\nI'm pausing contributions for the moment as Lunar has paid features and isn't compilable because of missing parts of the source code *(Pro features code is encrypted)*.\n\n### Building\nLunar can't be built from this repo as the source code for the paid features is hidden.\n","funding_links":[],"categories":["Applications","Utilities"],"sub_categories":["Utilities","Text","🛠️ Utilities (79)"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falin23%2Flunar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falin23%2Flunar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falin23%2Flunar/lists"}