{"id":13394545,"url":"https://github.com/anishathalye/lumen","last_synced_at":"2025-05-15T15:04:54.785Z","repository":{"id":56199746,"uuid":"64570768","full_name":"anishathalye/lumen","owner":"anishathalye","description":"Magic auto brightness based on screen contents 💡","archived":false,"fork":false,"pushed_at":"2023-03-05T12:48:06.000Z","size":2237,"stargazers_count":2293,"open_issues_count":1,"forks_count":53,"subscribers_count":45,"default_branch":"master","last_synced_at":"2025-04-07T20:09:45.982Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://anishathalye.com/lumen/","language":"Objective-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/anishathalye.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2016-07-31T01:06:11.000Z","updated_at":"2025-03-30T13:34:04.000Z","dependencies_parsed_at":"2024-01-06T13:09:47.710Z","dependency_job_id":"4fcde668-1a61-49a1-99ee-1d9c5fbaa73c","html_url":"https://github.com/anishathalye/lumen","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anishathalye%2Flumen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anishathalye%2Flumen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anishathalye%2Flumen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anishathalye%2Flumen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/anishathalye","download_url":"https://codeload.github.com/anishathalye/lumen/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254364270,"owners_count":22058878,"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-07-30T17:01:23.357Z","updated_at":"2025-05-15T15:04:54.764Z","avatar_url":"https://github.com/anishathalye.png","language":"Objective-C","funding_links":[],"categories":["Objective-C","Utilities"],"sub_categories":[],"readme":"# Lumen\n\nLumen is a menu bar application for macOS that magically sets the screen\nbrightness based on your screen contents.\n\n**You control Lumen simply by using your brightness keys - it'll automatically\nlearn your preferences.**\n\nLumen will automatically brighten the screen when you're looking at a dark\nwindow (for example, a full-screen terminal) and it'll automatically darken the\nscreen when you're looking at a bright window (for example, a web browser).\nThis makes for a much more pleasant experience, especially at night.\n\n## Demo\n\n![Demo][demo]\n\nWithout Lumen, web pages are too bright, and the terminal is too dark to read.\nWith Lumen, it's perfect.\n\n## Download\n\nThe easiest way to install Lumen is to use [Homebrew Cask][cask]:\n\n```bash\nbrew install --cask --no-quarantine lumen\n```\n\nOn macOS 11, you will need to grant screen recording permission to Lumen (it\ngrabs the screen to see whether dark or light content is being displayed). You\ncan grant the permission when it's first requested, or you can go to System\nPreferences \u003e Security \u0026 Privacy \u003e Privacy \u003e Screen Recording and [check the\nbox](https://raw.githubusercontent.com/anishathalye/assets/master/lumen/screen-record.png)\nnext to Lumen.\n\nIf you prefer, you can manually install the binary. You can find pre-built\nbinaries [here][releases].\n\nAs of now, releases are not signed with a developer key. To open unsigned\napplications for the first time, use [this method][opening-unsigned].\n\n## Notes\n\n- Lumen isn't supposed to work with auto brightness enabled, so be sure to\n  disable the \"automatically adjust brightness as ambient light changes\"\n  feature in System Preferences. Lumen also isn't compatible with f.lux or\n  Night Shift, so it may not work properly while you are using those.\n- Lumen does not natively support external monitors. If you want to control the\n  brightness of an external monitor with Lumen, you can use [Lunar] to [sync\n  your external monitor's brightness with your laptop\n  screen](https://github.com/anishathalye/lumen/issues/6#issuecomment-900464865).\n\n## Contributing\n\nFeature requests, bug reports, and pull requests are all appreciated.\n\n## Related Projects\n\n* [bencevans/lumenaire](https://github.com/bencevans/lumenaire) - a **cross\n  platform** implementation of Lumen written in **Node.js**\n* [epilande/lux](https://github.com/epilande/lux) - a **cross platform**\n  implementation of Lumen written in **Node.js**\n* [meh/dux](https://github.com/meh/dux) - a **Linux** implementation of Lumen\n  (with some extra features) written in **Rust**\n* [maximbaz/wluma](https://github.com/maximbaz/wluma) - a **Linux** implementation of Lumen\n  (with some extra features) written in **C**\n* [autolume/autolux](https://github.com/autolume/autolux) - a **Linux**\n  implementation of Lumen written in **Python**\n* [AlaaAlShammaa/Luminance](https://github.com/AlaaAlShammaa/Luminance) - a\n  **Windows** implementation of Lumen written in **Java**\n\nNote: I haven't personally audited the code from these projects.\n\n## License\n\nCopyright (c) Anish Athalye. Released under GPLv3. See\n[LICENSE.txt][license] for details.\n\n[demo]: assets/demo.gif\n[cask]: https://caskroom.github.io/\n[opening-unsigned]: https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unidentified-developer-mh40616/mac\n[releases]: https://github.com/anishathalye/lumen/releases\n[license]: LICENSE.txt\n[Lunar]: https://lunar.fyi/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanishathalye%2Flumen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanishathalye%2Flumen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanishathalye%2Flumen/lists"}