{"id":13634289,"url":"https://github.com/AlexPerathoner/SlimHUD","last_synced_at":"2025-04-18T14:34:04.750Z","repository":{"id":45744243,"uuid":"244049159","full_name":"AlexPerathoner/SlimHUD","owner":"AlexPerathoner","description":"Replacement for MacOS' volume, brightness and keyboard backlight HUDs.","archived":false,"fork":false,"pushed_at":"2025-03-22T17:41:11.000Z","size":210068,"stargazers_count":412,"open_issues_count":26,"forks_count":10,"subscribers_count":7,"default_branch":"develop","last_synced_at":"2025-03-22T18:19:21.883Z","etag":null,"topics":["brightness","huds","keyboard-backlight","macos","touchbar","utilities","volume"],"latest_commit_sha":null,"homepage":"https://alexperathoner.github.io/SlimHUD","language":"Swift","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/AlexPerathoner.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"docs/Support/README.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["AlexPerathoner"]}},"created_at":"2020-02-29T22:12:46.000Z","updated_at":"2025-03-22T17:06:07.000Z","dependencies_parsed_at":"2024-01-02T21:56:13.801Z","dependency_job_id":"c2a09a8a-b377-416e-a44e-7b2d71d769f1","html_url":"https://github.com/AlexPerathoner/SlimHUD","commit_stats":null,"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexPerathoner%2FSlimHUD","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexPerathoner%2FSlimHUD/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexPerathoner%2FSlimHUD/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexPerathoner%2FSlimHUD/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AlexPerathoner","download_url":"https://codeload.github.com/AlexPerathoner/SlimHUD/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249505563,"owners_count":21282909,"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":["brightness","huds","keyboard-backlight","macos","touchbar","utilities","volume"],"created_at":"2024-08-01T23:01:00.949Z","updated_at":"2025-04-18T14:33:59.733Z","avatar_url":"https://github.com/AlexPerathoner.png","language":"Swift","readme":"\u003c!--©Alexander Perathoner 19/03/2020--\u003e\n\n\u003cimg align=\"right\" width=\"25%\" src=\"Screens/Icon1024.png\"\u003e \n\n# SlimHUD\n[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2FAlexPerathoner%2FSlimHUD.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2FAlexPerathoner%2FSlimHUD?ref=badge_shield)\n[![CodeFactor](https://www.codefactor.io/repository/github/alexperathoner/slimhud/badge)](https://www.codefactor.io/repository/github/alexperathoner/slimhud)\n[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=alexpera_slimhud\u0026metric=alert_status)](https://sonarcloud.io/summary/new_code?id=alexpera_slimhud)\n\n\nReplacement for MacOS' HUDs.\n\nEvery day you change your volume or brightness and an ugly and unbelievably old overlay animation appears. *SlimHUD* is what you need.\n## Features - Settings\nEach feature can be toggled from the settings window.\u003cbr\u003eTo access the settings window start SlimHUD again, while it's already running. The settings window will appear:\n\n\n\u003cp align=\"center\"\u003e\n\u003cimg src = \"Screens/settings/settings-general.png\" height=300\u003e\n\u003cimg src = \"Screens/settings/settings-style.png\" height=300\u003e\n\u003cimg src = \"Screens/settings/settings-design.png\" height=300\u003e\n\u003c/p\u003e\n\nHere's are some of the things you can customise:\n\n* When changing volume / brightness / keyboard's backlight a small **icon** is shown under the bar.\n\n* If you don't like the flat look of the bar you can enable a **shadow** effect.\n\u003cp align=\"center\"\u003e\n\t\u003cimg src = \"Screens/shadows.gif\" height=250\u003e\n\u003c/p\u003e\n\n\n* There are multiple **animation** styles: \n\n|\u003cimg src = \"Screens/animations/no.gif\" height=250\u003e|\u003cimg src = \"Screens/animations/fade.gif\" height=250\u003e|\u003cimg src = \"Screens/animations/grow.gif\" height=250\u003e|\u003cimg src = \"Screens/animations/popinfadeout.gif\" height=250\u003e|\u003cimg src = \"Screens/animations/shrink.gif\" height=250\u003e|\u003cimg src = \"Screens/animations/side.gif\" height=250\u003e|\u003cimg src = \"Screens/animations/sidegrow.gif\" height=250\u003e|\n|--:|---|---|---|---|---|--:|\n\n* Continuously check for changes (*recommended if you use a **TouchBar***): shows the HUDs when using the volume / brightness slider.\n\n* Each bar (volume / brightness / keyboard's backlight) has it's own **color**.\u003cbr\u003eYou can also choose the color of the volume when its muted.\n\u003cp align=\"center\"\u003e\n\u003cimg src = \"Screens/volumeDisabled.gif\" height=250\u003e\n\u003c/p\u003e\n\n* Each **icon** (volume / brightness / keyboard's backlight) also has it's own color! \u003csup\u003e[1](#note1)\u003c/sup\u003e\n\n* If you think that the default bar is too small you can easily adjust its **size**.\n\n|\u003cimg src = \"Screens/Size/small.png\"\u003e|\u003cimg src = \"Screens/Size/middle.png\"\u003e|\u003cimg src = \"Screens/Size/big.png\"\u003e|\n|--:|---|--:|\n\n* The HUDs can appear on any **edge**: left, right, bottom or top; it's up to you!\n\n|\u003cimg src = \"Screens/Position/left.png\"\u003e|\u003cimg src = \"Screens/Position/right.png\"\u003e|\n|--:|---|\n|\u003cimg src = \"Screens/Position/top.png\"\u003e|\u003cimg src = \"Screens/Position/bottom.png\"\u003e|\n\n\n* Lastly don't forget to enable the **launch at login** function!\n\n\u003ca name=\"note1\"\u003e\u003c/a\u003e\u003csup\u003e[1](#note1)\u003c/sup\u003e:\n\u003e Only available in MacOS 10.14 and later.\n\n## Installation\nYou can use `brew install slimhud`!\n\nOr download the [latest release](https://github.com/AlexPerathoner/SlimHUD/releases/latest) and move it to `/Applications`.\n\nCredits to [GameParrot](https://github.com/GameParrot) for making it so easy!\n\n\n### Uninstalling\nIf you'd like to restore the system's HUDs:\n\n1. Disable \"launch at login\" or delete SlimHUD from `/Applications`\n\n## Credits\nThanks to [w0lfschild](https://gist.github.com/w0lfschild) and [massimobio](https://gist.github.com/massimobio) for creating respectively\n [cleanHUD](https://github.com/w0lfschild/cleanHUD) and [ProgressHUD-Mac](https://github.com/massimobio/ProgressHUD-Mac) and inspiring me to create this project.\n \nAlso thanks to [pirate](https://gist.github.com/pirate) and [kaunteya](https://gist.github.com/kaunteya), whose code from these project ([mac-keyboard-brightness](https://github.com/pirate/mac-keyboard-brightness) and [ProgressKit](https://github.com/kaunteya/ProgressKit)) was used to complete this project.\n\nThanks to [reitermarkus](https://gist.github.com/reitermarkus), [ans87gh](https://gist.github.com/ans87gh) and [p-linnane](https://gist.github.com/p-linnane) for adding this project to brew.\n \nSlimHUD is using [Sparkle](https://sparkle-project.org) to support automatic updates. Binaries are stored on GitHub and connections use HTTPs.\n\n## Support\nEven starring this project is a great support! If you want to support me even more, you can buy me a beer! :D\n\n\u003cbr\u003e\u003ca href=\"https://www.buymeacoffee.com/alexpera\"\u003e\u003cimg src=\"https://img.buymeacoffee.com/button-api/?text=Buy me a beer\u0026emoji=🍺\u0026slug=alexpera\u0026button_colour=94e3fe\u0026font_colour=000000\u0026font_family=Bree\u0026outline_colour=000000\u0026coffee_colour=FFDD00\" /\u003e\u003c/a\u003e\n\n## License\n\nThis project is licensed under the GPL-3.0 License - see the [LICENSE.md](LICENSE.md) file for details\n\n\n[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2FAlexPerathoner%2FSlimHUD.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2FAlexPerathoner%2FSlimHUD?ref=badge_large)","funding_links":["https://github.com/sponsors/AlexPerathoner","https://www.buymeacoffee.com/alexpera","https://img.buymeacoffee.com/button-api/?text=Buy"],"categories":["Swift","Utilities","Applications"],"sub_categories":["Text","Utilities","🛠️ Utilities (79)"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAlexPerathoner%2FSlimHUD","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAlexPerathoner%2FSlimHUD","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAlexPerathoner%2FSlimHUD/lists"}