You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
> We don't have an Apple Developer account yet. The application will show a popup on first start. Click **Okay**, then, go to **Settings / Privacy & Security** and scroll down until you see a button called **Open anyway**. You'll only have to do this once.
17
+
<!--Welcome to **Boring.Notch**, the coolest way to make your MacBook's notch the star of the show! Forget about those boring status bars—our notch turns into a dynamic music control center, complete with a snazzy visualizer and all the music controls you need. It's like having a mini concert right at the top of your screen! -->
11
18
12
-
## Website
13
-
> [!NOTE]
14
-
> Hey There 👋 We have a new website at https://theboring.name! Go check it out for stuff like:
15
-
> - All current bugs
16
-
> - People's opinions about Boring.Notch
17
-
> - All current features
18
-
> - Q&A answers
19
+
Say hello to **Boring Notch**, the coolest way to make your MacBook’s notch the star of the show! Say goodbye to boring status bars: with Boring Notch, your notch transforms into a dynamic music control center, complete with a vibrant visualizer and all the essential music controls you need. But that’s just the start! Boring Notch also offers calendar integration, a handy file shelf with AirDrop support and more!
[](https://star-history.com/#TheBoredTeam/boring.notch&Timeline)
<ahref="https://www.buymeacoffee.com/jfxh67wvfxq"target="_blank"><imgsrc="https://cdn.buymeacoffee.com/buttons/v2/default-red.png"alt="Buy Me A Coffee"style="height: 60px!important;width: 217px!important;" ></a>
40
+
**System Requirements:**
41
+
- macOS **14 Sonoma** or later
42
+
- Apple Silicon or Intel Mac
27
43
28
-
## Join our Discord Server (new)
44
+
---
45
+
> [!IMPORTANT]
46
+
> We don't have an Apple Developer account yet. The application will show a popup on first launch that the app is from an unidentified developer.
47
+
> 1. Click **OK** to close the popup.
48
+
> 2. Open **System Settings** > **Privacy & Security**.
49
+
> 3. Scroll down and click **Open Anyway** next to the warning about the app.
50
+
> 4. Confirm your choice if prompted.
51
+
>
52
+
> You only need to do this once.
29
53
30
-
<ahref="https://discord.gg/GvYcYpAKTu"target="_blank"><imgsrc="https://iili.io/28m3GHv.png"alt="Join The Boring Server!"style="height: 60px!important;width: 217px!important;" ></a>
31
54
32
-
## Preview
55
+
### Option 1: Download and Install Manually
56
+
<ahref="https://github.com/TheBoredTeam/boring.notch/releases/latest/download/Flying_Rabbit.dmg"target="_self"><imgwidth="200"src="https://github.com/user-attachments/assets/e3179be1-8416-4b8a-b417-743e1ecc67d6"alt="Download for macOS" /></a>
Welcome to **Boring.Notch**, the coolest way to make your MacBook's notch the star of the show! Forget about those boring status bars—our notch turns into a dynamic music control center, complete with a snazzy visualizer and all the music controls you need. It's like having a mini concert right at the top of your screen!
60
+
### Option 2: Install via Homebrew
37
61
62
+
You can also install the app using [Homebrew](https://brew.sh):
- Launch the app, and voilà—your notch is now the coolest part of your screen.
71
+
- Hover over the notch to see it expand and reveal all its secrets.
72
+
- Use the controls to manage your music like a rockstar.
73
+
74
+
## 📋 Roadmap
75
+
-[x] Playback live activity 🎧
76
+
-[x] Calendar integration 📆
77
+
-[x] Mirror 📷
78
+
-[x] Charging indicator and current percentage 🔋
79
+
-[x] Customizable gesture control 👆🏻
80
+
-[x] Shelf functionality with AirDrop 📚
81
+
-[x] Notch sizing customization, finetuning on different display sizes 🖥️
82
+
-[ ] Customizable Layout options 🛠️
83
+
-[ ] Extension system 🧩
84
+
-[ ] System HUD replacements (volume, brightness, backlight) 🎚️💡⌨️
85
+
-[ ] Notifications (under consideration) 🔔
86
+
<!-- - [ ] Clipboard history manager 📌 `Extension` -->
87
+
<!-- - [ ] Download indicator of different browsers (Safari, Chromium browsers, Firefox) 🌍 `Extension`-->
88
+
<!-- - [ ] Customizable function buttons 🎛️ -->
89
+
<!-- - [ ] App switcher 🪄 -->
90
+
91
+
<!-- ## 🧩 Extensions
92
+
> [!NOTE]
93
+
> We’re hard at work on some awesome extensions! Stay tuned, and we’ll keep you updated as soon as they’re released. -->
41
94
42
-
## 🚀 Getting Started
95
+
## Building from Source
43
96
44
97
### Prerequisites
45
98
46
-
-**A MacBook**: With a boring notch (Not Needed).
47
-
-**macOS 14.2 or later**: If you’re not on the latest macOS, we might need to send a search party.
48
-
-**Xcode 15.0 or later**: This is where the magic happens, so make sure it’s up-to-date.
99
+
-**macOS 14 or later**: If you’re not on the latest macOS, we might need to send a search party.
100
+
-**Xcode 16 or later**: This is where the magic happens, so make sure it’s up-to-date.
49
101
50
102
### Installation
51
103
@@ -61,37 +113,8 @@ Welcome to **Boring.Notch**, the coolest way to make your MacBook's notch the st
61
113
```
62
114
63
115
3.**Build and Run**:
64
-
- Select your target device (MacBook—you do have one, right?).
65
116
- Click the "Run" button or press `Cmd + R`. Watch the magic unfold!
66
117
67
-
## 🎸 Usage
68
-
69
-
- Launch the app, and voilà—your notch is now the coolest part of your screen.
70
-
- Hover over the notch to see it expand and reveal all its secrets.
71
-
- Use the controls to manage your music like a rockstar.
72
-
73
-
## 📋 Roadmap
74
-
-[x] Proper notch sizing and animations 📐
75
-
-[x] Delayed notch opening ⏲️
76
-
-[x] Charging indicator and current percentage 🔋
77
-
-[x] Playback live activity 🎧
78
-
-[x] Calendar integration 📆
79
-
-[x] Customizable gesture control 👆🏻
80
-
-[x] Shelf functionality with AirDrop 📚
81
-
-[ ] Extension system 🧩
82
-
-[ ] Clipboard history manager 📌 `Extension`
83
-
-[ ] System HUD replacements (volume, brightness, backlight) 🎚️💡⌨️ `Extension`
84
-
-[ ] Download indicator of different browsers (Safari, Chromium browsers, Firefox) 🌍 `Extension`
85
-
-[ ] Customizable function buttons 🎛️
86
-
-[ ] Layout customization options 🛠️
87
-
-[ ] Notch sizing customization, finetuning on different display sizes 🖥️
88
-
-[ ] App switcher 🪄
89
-
-[ ] Notifications (under consideration) 🔔
90
-
91
-
## 🧩 Extensions
92
-
> [!NOTE]
93
-
> We’re hard at work on some awesome extensions! Stay tuned, and we’ll keep you updated as soon as they’re released.
94
-
95
118
## 🤝 Contributing
96
119
97
120
We’re all about good vibes and awesome contributions! Here’s how you can join the fun:
@@ -122,13 +145,32 @@ We’re all about good vibes and awesome contributions! Here’s how you can joi
122
145
```
123
146
8.**Create a Pull Request**: Head to the original repository and click on "New Pull Request." Fill in the required details, **make sure the base branch is set to `dev`**, and submit your PR. Let’s see what you’ve got!
124
147
125
-
## 📝 License
148
+
## Join our Discord Server
126
149
127
-
This work is licensed under the Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc-nd/4.0/.
150
+
<ahref="https://discord.gg/GvYcYpAKTu"target="_blank"><imgsrc="https://iili.io/28m3GHv.png"alt="Join The Boring Server!"style="height: 60px!important;width: 217px!important;" ></a>
<imgalt="Star History Chart"src="https://api.star-history.com/svg?repos=TheBoredTeam/boring.notch&type=Timeline" />
159
+
</picture>
160
+
</a>
161
+
162
+
## Buy us a coffee!
163
+
164
+
<ahref="https://www.buymeacoffee.com/jfxh67wvfxq"target="_blank"><imgsrc="https://cdn.buymeacoffee.com/buttons/v2/default-red.png"alt="Buy Me A Coffee"style="height: 60px!important;width: 217px!important;" ></a>
128
165
129
166
## 🎉 Acknowledgments
130
167
131
-
We would like to express our appreciation to the developers of [NotchDrop](https://github.com/Lakr233/NotchDrop), an open-source project that has been instrumental in developing the "Shelf" feature in Boring.notch. Special thanks to Lakr233 for their contributions to NotchDrop and to [Hugo Persson](https://github.com/Hugo-Persson) for integrating it into our project.
168
+
We would like to express our appreciation to the developers of [NotchDrop](https://github.com/Lakr233/NotchDrop), an open-source project that has been instrumental in developing the "Shelf" feature in Boring Notch. Special thanks to Lakr233 for their contributions to NotchDrop and to [Hugo Persson](https://github.com/Hugo-Persson) for integrating it into our project.
The Bored Team and community take security bugs in Boring Notch seriously. We appreciate your efforts to responsibly disclose your findings, and will make every effort to acknowledge your contributions.
6
+
7
+
To report a security issue, please use the GitHub Security Advisory ["Report a Vulnerability"](https://github.com/TheBoredTeam/boring.notch/security/advisories/new) tab.
8
+
9
+
The Bored Team will send a response indicating the next steps in handling your report. After the initial reply to your report, we will keep you informed of the progress towards a fix and full announcement, and may ask for additional information or guidance.
10
+
11
+
Report security bugs in third-party dependencies to the person or team maintaining the package or dependency.
0 commit comments