{"id":50486488,"url":"https://github.com/chountalas/luma","last_synced_at":"2026-06-01T23:00:30.259Z","repository":{"id":360367349,"uuid":"1247195559","full_name":"chountalas/Luma","owner":"chountalas","description":"Native Apple Silicon macOS menu bar app for screen warmth, dimming, and scheduled day/night display profiles.","archived":false,"fork":false,"pushed_at":"2026-05-26T04:42:16.000Z","size":1165,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-26T06:31:03.322Z","etag":null,"topics":["apple-silicon","blue-light-filter","color-temperature","display","flux","macos","menu-bar","night-shift","swift","swiftui"],"latest_commit_sha":null,"homepage":"https://github.com/chountalas/Luma/releases","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/chountalas.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":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-23T02:30:30.000Z","updated_at":"2026-05-26T04:42:20.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/chountalas/Luma","commit_stats":null,"previous_names":["chountalas/luma"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/chountalas/Luma","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chountalas%2FLuma","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chountalas%2FLuma/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chountalas%2FLuma/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chountalas%2FLuma/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chountalas","download_url":"https://codeload.github.com/chountalas/Luma/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chountalas%2FLuma/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33797128,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-01T02:00:06.963Z","response_time":115,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["apple-silicon","blue-light-filter","color-temperature","display","flux","macos","menu-bar","night-shift","swift","swiftui"],"created_at":"2026-06-01T23:00:23.838Z","updated_at":"2026-06-01T23:00:30.254Z","avatar_url":"https://github.com/chountalas.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Luma\n\nLuma is a clean-room, native Apple Silicon macOS menu bar utility for screen warmth, dimming, and scheduled day/night display profiles.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/luma-panel.png\" alt=\"Luma menu bar panel showing the day/night arc, strength presets, and warmth, brightness, and dim sliders\" width=\"360\"\u003e\n\u003c/p\u003e\n\nLuma does not reuse Iris source code, assets, license behavior, or private app data. It is not affiliated with Iris, iristech.co, or any Iris product.\n\nPresets let you switch the overall display effect between Clear, Light, Subtle, Balanced, Strong, Deep, Reading, Late Night, and Custom. Presets update day, night, and sleep profiles together; manual slider changes switch the app to Custom.\n\n## Features\n\n- Warmth (color temperature) and dimming control from the menu bar\n- Day, Night, and Sleep profiles that switch automatically\n- Nine built-in presets plus a Custom mode driven by manual sliders\n- Sunset/sunrise scheduling from your latitude/longitude, or a manual time window\n- Global hotkeys for quick adjustments without opening the app\n- Optional one-time importer for existing Iris visual and schedule settings\n- CoreGraphics gamma adjustment with a click-through overlay fallback for displays that reject direct gamma changes\n\n## Requirements\n\n- macOS 14.0 or later\n- Apple Silicon Mac\n\n## Download And Install\n\nWith Homebrew:\n\n```bash\nbrew install --cask chountalas/tap/luma\n```\n\nTo update later:\n\n```bash\nbrew upgrade --cask luma\n```\n\nDownload the latest `Luma-*-arm64.dmg` from the [Releases](https://github.com/chountalas/Luma/releases) page, open it, and drag Luma into Applications.\n\nPublic builds are signed with a Developer ID and notarized by Apple, so they open without a Gatekeeper warning. To build from source instead, see below.\n\n## Privacy\n\nLuma stores its own settings in the local macOS defaults store for the app. The optional Iris importer reads only the current user's local Iris preferences plist and maps visual and schedule values into Luma settings. It does not read Iris source code, license data, account data, or private app data.\n\n## Build And Run\n\nInstall Xcode and XcodeGen, then run:\n\n```bash\n./script/build_and_run.sh --verify\n```\n\nThe app uses a CoreGraphics gamma table where macOS allows it and falls back to click-through overlay windows if a display rejects direct gamma changes.\n\nQuit other display-filter apps before using Luma as the daily driver. Running multiple display filters at the same time can make them override each other.\n\n## Package A Downloadable App\n\n```bash\n./script/package_release.sh\n```\n\nThis produces:\n\n- `dist/Luma-0.1.6-arm64.dmg`\n- `dist/Luma-0.1.6-arm64.zip`\n- `dist/checksums.txt`\n\nThe local package is signed ad hoc by default. For a no-warning public download, set `CODE_SIGN_IDENTITY` to a Developer ID Application certificate and notarize the DMG.\n\n## Contributing\n\nIssues and pull requests are welcome for bug fixes, compatibility improvements, and small usability improvements. Please keep changes focused and include a local build or test result when possible.\n\nFor security issues, see `SECURITY.md`.\n\n## License\n\nLuma is released under the MIT License. See `LICENSE`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchountalas%2Fluma","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchountalas%2Fluma","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchountalas%2Fluma/lists"}