https://github.com/monuk7735/mew-notch
Make the Notches on newer Macs Useful!
https://github.com/monuk7735/mew-notch
apple hud macos notch
Last synced: 5 months ago
JSON representation
Make the Notches on newer Macs Useful!
- Host: GitHub
- URL: https://github.com/monuk7735/mew-notch
- Owner: monuk7735
- License: gpl-3.0
- Created: 2025-02-26T17:53:25.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-31T12:31:34.000Z (about 1 year ago)
- Last Synced: 2025-03-31T13:51:17.789Z (about 1 year ago)
- Topics: apple, hud, macos, notch
- Language: Swift
- Homepage:
- Size: 462 KB
- Stars: 93
- Watchers: 1
- Forks: 4
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-swift-macos-apps - MewNotch - notch?label=" /> <img align="bottom" height="13" src="https://img.shields.io/github/last-commit/monuk7735/mew-notch?style=flat&label=" /> - By displaying volume and brightness changes on the notch, it replaces the default system HUD. (Notch App / Text)
README
MewNotch
Make the Mac Notch Actually Useful!
MewNotch is a free, open-source macOS app that transforms the notch into a customizable HUD for brightness, volume, power, and more. Minimal, beautiful, and privacy-friendly.
[](LICENSE)
[](https://github.com/monuk7735/mew-notch/releases)
[](https://github.com/monuk7735/mew-notch/issues)
[](https://github.com/monuk7735/mew-notch/pulls)
[](https://www.apple.com/macos/)
## Features
- **Brightness Display** - Displays brightness adjustments in real-time, including optional auto-brightness changes.
- **Sound Level Display** - Shows input/output volume changes directly on the notch.
- **System HUD Suppression** - Option to completely hide the stock macOS HUDs for a cleaner experience.
- **File Shelf** - Drag and drop files to the notch for quick access. **Now with Persistence!** Files stay there even after restarts.
- **Power State** - Show current power source. **New:** Toggle "Time Remaining" display for a cleaner look.
- **Notch on Lock Screen** - The notch HUD is now visible even on the macOS lock screen.
- **Now Playing** - Control now playing media directly from notch. Expand notch for additional controls.
- **Mirror** - Get a quick peek on how you're looking by using the mirror in expanded notch. Now with customizable corner radius.
- **Auto Updates** - Built-in updater (Sparkle) to keep your app always up to date.
- **Modern Settings UI** - Completely redesigned settings experience for easier customization.
- **Fully Custom Notch Experience** - Choose the displays you want to see the notch on.
- **SwiftUI-based UI** - Smooth animations and modern macOS styling.
## Installation
1. Download the latest release from [GitHub Releases](https://github.com/monuk7735/mew-notch/releases).
2. Move the app to the Applications folder.
3. Run the app and grant necessary permissions if prompted.
> ### Note!
> I don't have an Apple Developer account yet, so the application will display a popup on the first launch.
>
> Click Okay, then navigate to **Settings > Privacy & Security**, scroll down, and click **Open Anyway**.
>
> This only needs to be done once.
## Usage
1. Launch **MewNotch**.
2. Re-launch to open settings, if required. Notch won't appear at first launch on non-notched devices.
3. Adjust the volume or brightness using Keyboard or Touch Bar.
4. Customise the settings to have notch on different or all monitors.
5. Enjoy the sleek visual feedback right on the notch!
## Roadmap
- [x] ~~Add support for different types of HUD UIs.~~
- [x] ~~Allow users to toggle usage of each HUD variant.~~
- [x] ~~Icon in Menu bar to show app's running status.~~
- [x] ~~Add Touch bar support.~~
- [x] ~~Now playing music HUD.~~
- [x] ~~Actions on Now Playing HUD. Hover to see magic.~~
- [x] ~~Now Playing Detail on Expanded Notch View.~~
- [x] ~~Expand notch on hover.~~
- [x] ~~Mirror View~~
- [x] ~~Complete Control over which monitor shows the notch~~
- [x] ~~Explore different options for Now Playing media support on macOS 15.4 and above.~~
- [x] ~~Shelf for files in expanded notch view~~
- [x] ~~Persist Shelf Files across restarts~~
- [ ] Making shelf work with **Show on Lockscreen** enabled (Currently mutually exclusive for security).
- [ ] HUD for displaying keyboard backlight changes.
- [ ] Explore additional notch-based utilities.
## Dependency
- [Lottie](https://github.com/airbnb/lottie-ios)
- [LaunchAtLogin-Modern](https://github.com/sindresorhus/LaunchAtLogin-Modern)
- [SwiftyJSON](https://github.com/SwiftyJSON/SwiftyJSON)
- [Sparkle](https://github.com/sparkle-project/Sparkle)
## Contributing
Contributions are welcome! Feel free to open issues or submit pull requests.
## License
This project is licensed under the [GPLv3 License](LICENSE).
## Acknowledgments
- Inspired by the idea of making the Mac notch actually useful!
- Built with ♥️ using Swift and SwiftUI.
- Some parts built with 😭 using Objective-C for system integration.
- Special thanks to the following GitHub repositories for their code and inspiration:
- [mediaremote-adapter](https://github.com/ungive/mediaremote-adapter)
- [SlimHUD](https://github.com/AlexPerathoner/SlimHUD)
- [SkyLightWindow](https://github.com/Lakr233/SkyLightWindow)
- [EnergyBar](https://github.com/billziss-gh/EnergyBar)
- [boring.notch](https://github.com/TheBoredTeam/boring.notch)