{"id":13859083,"url":"https://github.com/igorkulman/ChangeMenuBarColor","last_synced_at":"2025-07-14T01:32:51.295Z","repository":{"id":38262760,"uuid":"313378241","full_name":"igorkulman/ChangeMenuBarColor","owner":"igorkulman","description":"Simple utility to change macOS Big Sur and Monterey menu bar color by appending a solid color or gradient rectangle to a wallpaper image","archived":false,"fork":false,"pushed_at":"2023-08-07T11:18:25.000Z","size":1497,"stargazers_count":966,"open_issues_count":15,"forks_count":37,"subscribers_count":11,"default_branch":"main","last_synced_at":"2024-11-22T07:04:44.017Z","etag":null,"topics":["bigsur","macos","monterey","swift","swiftpackage","xcode"],"latest_commit_sha":null,"homepage":"","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/igorkulman.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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},"funding":{"custom":["https://www.buymeacoffee.com/igorkulman","https://www.paypal.com/cgi-bin/webscr?cmd=_donations\u0026business=WND2WGRGBLQVE\u0026currency_code=EUR"]}},"created_at":"2020-11-16T17:31:50.000Z","updated_at":"2024-11-15T03:11:22.000Z","dependencies_parsed_at":"2024-11-07T12:31:49.580Z","dependency_job_id":"73724b0d-b761-4aca-944f-2bc7acf3de7e","html_url":"https://github.com/igorkulman/ChangeMenuBarColor","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igorkulman%2FChangeMenuBarColor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igorkulman%2FChangeMenuBarColor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igorkulman%2FChangeMenuBarColor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/igorkulman%2FChangeMenuBarColor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/igorkulman","download_url":"https://codeload.github.com/igorkulman/ChangeMenuBarColor/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225938766,"owners_count":17548547,"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":["bigsur","macos","monterey","swift","swiftpackage","xcode"],"created_at":"2024-08-05T03:02:31.948Z","updated_at":"2025-07-14T01:32:51.286Z","avatar_url":"https://github.com/igorkulman.png","language":"Swift","readme":"\u003ch1 align=\"center\"\u003e\u003ca id=\"user-content-change-menu-bar-color-in-macos-big-sur\" class=\"anchor\" aria-hidden=\"true\" href=\"#localization-editor\"\u003e\u003csvg class=\"octicon octicon-link\" viewBox=\"0 0 16 16\" version=\"1.1\" width=\"16\" height=\"16\" aria-hidden=\"true\"\u003e\u003cpath fill-rule=\"evenodd\" d=\"M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z\"\u003e\u003c/path\u003e\u003c/svg\u003e\u003c/a\u003eChange menu bar color in macOS Big Sur and Monterey\u003c/h1\u003e\n\nSimple utility to change macOS Big Sur and Monterey menu bar color by appending a solid color or gradient rectangle to a wallpaper image.\n\n## Motivation\n\nBig Sur and Monterey changed the way the menu bar is displayed. It now adopts the color of the wallpaper, which may not always be what you would like. This utility allows you to specify the solid color or gradient of the menu bar you want to use.\n\n### Example\n\nImagine you have a dark wallpaper ([here is mine](https://www.wallpaperflare.com/silhouette-of-mountain-simple-simple-background-minimalism-wallpaper-phxwd)). This dark wallpaper results in the menu bar being black even though you use the Light mode\n\n![Default menu bar color in macOS Big Sur](Screenshots/Dark.png)\n\nWith this utility you can generate a new wallpaper that makes the menu bar being shown in any color you want, like a nice tone of gray from Catalina.\n\n![Custom color menu bar in macOS Big Sur](Screenshots/Adjusted.png)\n\nOr a custom gradient\n\n![Gradient menu bar in macOS Big Sur](Screenshots/Gradient.png)\n\n## Installation\n\n### Mint\n\nThe easiest and preferred way to install and run the tools is with [Mint](ttps://github.com/yonaskolb/Mint).\n\nDue to [Swift Package Manager limitations](https://forums.swift.org/t/only-command-line-tools-installed-xctest-executable-not-found/34088) you need to have [Xcode](https://apps.apple.com/us/app/xcode/id497799835?mt=12) installed and opened at least once for the installation from source code to work.\n\nAfter you installed Xcode install [Mint](ttps://github.com/yonaskolb/Mint) with [Homebrew](https://brew.sh/)\n\n```bash\nbrew install mint\n```\n\nNext run \n\n```bash\nmint run igorkulman/ChangeMenuBarColor\n```\n\nand if everything is OK you can use my utility be downloaded and run for the first time. You are ready to go!\n\n### Binary release\n\nIf you do not want to install Xcode and Mint you can download [the latest binary release](https://github.com/igorkulman/ChangeMenuBarColor/releases/latest). \n\nThe binary release is not signed so it might not work on all systems.\n\n## Usage\n\nAll the commands shown are for the utility being installed via Mint. If you downloaded the latest binary release replace `mint run igorkulman/ChangeMenuBarColorSolidColor` with `path/to/unzipped/ChangeMenuBarColorSolidColor`.\n\n### Solid color\n\nTo set a new wallpaper file with a solid color rectangle that matches the menu bar, run\n\n```bash\nmint run igorkulman/ChangeMenuBarColorSolidColor \"desired_hex_color\" \"optional_path_to_your_wallpaper\" \n```\n\nSo for example\n\n```bash\nmint run igorkulman/ChangeMenuBarColor SolidColor \"#CCCCCC\" \"/Users/igorkulman/wallpaper.jpg\"\n```\n\nIf you do not provide the wallpaper path\n\n```bash\nmint run igorkulman/ChangeMenuBarColor SolidColor \"#CCCCCC\"\n```\n\nthe currently set wallpaper will be used.\n\n### Gradient\n\nTo set a new wallpaper file with a gradient rectangle at the top, run\n\n```bash\nmint run igorkulman/ChangeMenuBarColor Gradient \"start_hex_color\" \"end_hex_color\" \"optional_path_to_your_wallpaper\"\n```\n\nSo for example\n\n```bash\nmint run igorkulman/ChangeMenuBarColor Gradient \"#FF0000\" \"#00FF00\" \"/Users/igorkulman/wallpaper.jpg\"\n```\n\nIf you do not provide the wallpaper path\n\n```bash\nmint run igorkulman/ChangeMenuBarColor Gradient \"#FF0000\" \"#00FF00\"\n```\n\nthe currently set wallpaper will be used.\n\n#### Multiple displays\n\nIf you use multiple displays and want the wallpaper generated for all of them, add the `--all-displays` flag at the end of the command, so for example `./ChangeMenuBarColor Gradient \"#FF0000\" \"#00FF00\" --all-displays`.\n\n## Uninstall\n\n- manually set any new wallpaper\n- run `mint uninstall igorkulman/ChangeMenuBarColor` if you installed the utility via `mint` or delete the folder with the utility if you downloaded it manually.\n\n## Support the project\n\n\u003ca href=\"https://www.buymeacoffee.com/igorkulman\" target=\"_blank\"\u003e\u003cimg src=\"https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png\" alt=\"Buy Me A Coffee\" style=\"height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;\" \u003e\u003c/a\u003e\n\n## Known issues\n\nMake sure **Automatically hide and show the menu bar** is **disabled**. This setting causes the utility to incorrectly detect the menu bar size.\n\nDynamic wallpapers are not supported at the moment. If you use a dynamic wallpaper the utility will convert it to a static .jpg image.\n\n### Catalina support\n\nThe utility builds and runs on Catalina but the menu bar on Catalina works in a different way that on Big Sur and Monterey so the result will never be the same as on Big Sur and Monterey.\n\n## Contributing\n\nAll contributions are welcomed!\n\n## Author\n\n- **Igor Kulman** - *Initial work* - igor@kulman.sk\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","funding_links":["https://www.buymeacoffee.com/igorkulman","https://www.paypal.com/cgi-bin/webscr?cmd=_donations\u0026business=WND2WGRGBLQVE\u0026currency_code=EUR"],"categories":["Swift"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Figorkulman%2FChangeMenuBarColor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Figorkulman%2FChangeMenuBarColor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Figorkulman%2FChangeMenuBarColor/lists"}