An open API service indexing awesome lists of open source software.

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: 8 months ago
JSON representation

Make the Notches on newer Macs Useful!

Awesome Lists containing this project

README

          

# MewNotch - Make the Mac Notch Useful!

[![GitHub License](https://img.shields.io/github/license/monuk7735/mew-notch)](LICENSE)
[![Downloads](https://img.shields.io/github/downloads/monuk7735/mew-notch/total.svg)](https://github.com/monuk7735/mew-notch/releases)

MewNotch is a macOS app that enhances the functionality of the notch on new MacBooks by displaying volume and brightness changes, replacing the default system HUD with a modern and seamless experience.

## Features

- **Brightness Display** - Displays brightness adjustments in real-time.
- **Sound level Display** - Shows input/output volume changes directly on the notch.
- **Sound Device** - Shows current input/output device on notch, when changed.
- **Power State** - Show current power source as well as left time on battery when available.
- **Now Playing** - Control now playing media directly from notch. Expand notch for additional controls.
- **Minimal & Non-Intrusive** - A clean, lightweight alternative to the default system HUD.
- **Heavily Customizable** - Each HUD can be customised to have different styling.
- **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. 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.~~
- [ ] Add seek option to expanded now playing view.
- [ ] Make longer texts marquee in expanded now playing view.
- [ ] Explore additional notch-based utilities.

## 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.
- Special thanks to the following GitHub repositories for their code and inspiration:
- [SlimHUD](https://github.com/AlexPerathoner/SlimHUD)
- [boring.notch](https://github.com/TheBoredTeam/boring.notch)