Skip to content

AlexPerathoner/SlimHUD

Repository files navigation

SlimHUD

FOSSA Status CodeFactor Quality Gate Status

Replacement for MacOS' HUDs.

Every day you change your volume or brightness and an ugly and unbelievably old overlay animation appears. SlimHUD is what you need.

Features - Settings

Each feature can be toggled from the settings window.
To access the settings window start SlimHUD again, while it's already running. The settings window will appear:

Here's are some of the things you can customise:

  • When changing volume / brightness / keyboard's backlight a small icon is shown under the bar.

  • If you don't like the flat look of the bar you can enable a shadow effect.

  • There are multiple animation styles:
  • Continuously check for changes (recommended if you use a TouchBar): shows the HUDs when using the volume / brightness slider.

  • Each bar (volume / brightness / keyboard's backlight) has it's own color.
    You can also choose the color of the volume when its muted.

  • Each icon (volume / brightness / keyboard's backlight) also has it's own color! 1

  • If you think that the default bar is too small you can easily adjust its size.

  • The HUDs can appear on any edge: left, right, bottom or top; it's up to you!
  • Lastly don't forget to enable the launch at login function!

1:

Only available in MacOS 10.14 and later.

Installation

You can use brew install slimhud!

Or download the latest release and move it to /Applications.

Credits to GameParrot for making it so easy!

Uninstalling

If you'd like to restore the system's HUDs:

  1. Disable "launch at login" or delete SlimHUD from /Applications

Credits

Thanks to w0lfschild and massimobio for creating respectively cleanHUD and ProgressHUD-Mac and inspiring me to create this project.

Also thanks to pirate and kaunteya, whose code from these project (mac-keyboard-brightness and ProgressKit) was used to complete this project.

Thanks to reitermarkus, ans87gh and p-linnane for adding this project to brew.

SlimHUD is using Sparkle to support automatic updates. Binaries are stored on GitHub and connections use HTTPs.

Support

Even starring this project is a great support! If you want to support me even more, you can buy me a beer! :D


License

This project is licensed under the GPL-3.0 License - see the LICENSE.md file for details

FOSSA Status