Skip to content
This repository was archived by the owner on Jan 31, 2025. It is now read-only.

Commit e688716

Browse files
author
zkondor
committed
Initial README added
1 parent 4722dd2 commit e688716

11 files changed

+121
-1
lines changed

.github/FUNDING.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
github: [zkondor]

README.md

Lines changed: 99 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,99 @@
1-
# zNotch
1+
# zNotch: prompt control of Macbook's Notch
2+
3+
<div align="center">
4+
<p><u>(pronounced as "the Notch")</u></p>
5+
6+
<img src="media/toggle-cycle.png" width="400" alt="Toggle any time"/>
7+
<img src="media/control-way.png" width="400" alt="Control the way you need"/>
8+
9+
<a href="https://github.com/zkondor/znotch/releases/download/v1.0.0/znotch-1.0.0.dmg"><img src="media/download-app-for-macos.png" width="155" alt="Download zNotch App for macOS"/></a>
10+
<a href="https://github.com/zkondor/homebrew-dist"><img src="media/download-app-homebrew.png" width="155" alt="Download zNotch App using Homebrew"/></a>
11+
</div>
12+
13+
> Macbook's (in)famous Notch doesn't bother me the most of the time. Once this happens or I need more screen's space for a while, I want to be able toggling/removing it in efficient and prompt way: either through a hotkey or through my own automation.
14+
15+
Sounds this familiar, `zNotch` is more likely a 💯 choice of yours as well as mine.
16+
17+
<div align="center">
18+
19+
![Demo Time!](media/usage-demo.gif)
20+
21+
</div>
22+
23+
## Highlights
24+
25+
### No Extra Permissions
26+
27+
Sandboxed. `zNotch` doesn't require **any** system permissions and runs right away after installation.
28+
29+
### Trusted
30+
31+
Signed by Apple. `zNotch` has passed all Apple's checks required to receive a security signature. No warnings from Apple's Gatekeeper about suspicious software.
32+
33+
## Raycast Integration 🤩
34+
35+
[`Raycast`](https://raycast.com) is a great drop-in replacement for a built-in `Spotlight`. There is an extension to control `zNotch` over `Raycast`'s omnibar.
36+
37+
<div align="center">
38+
<a href="https://www.raycast.com/zkondor/znotch"><img src="https://www.raycast.com/zkondor/znotch/[email protected]" style="height: 64px;" alt="" height="64"></a>
39+
</div>
40+
41+
### Shortcuts/Automation Friendly
42+
43+
Hide, show and just toggle back and forth your Macbook's Notch using:
44+
45+
- Menubar
46+
- Command line
47+
48+
Notch control over a command line allows to have/build own automation routine.
49+
50+
### Free
51+
52+
No strings attached. Ever.
53+
54+
Like the app? Just spread the word!
55+
56+
See the [license](license.txt) for the terms of use and credits. `Apple`, `Macbook`, `Raycast` are the trademarks of their legal owners.
57+
58+
<hr/>
59+
60+
## Download
61+
62+
Get a `.dmg` with the [latest release](https://github.com/zkondor/znotch/releases).
63+
64+
Or stay always up to date using [Brew](https://github.com/zkondor/homebrew-dist):
65+
66+
``` sh
67+
brew tap zkondor/dist
68+
brew install --cask znotch
69+
```
70+
71+
## Feedback
72+
73+
Every one of them matters [over there](https://github.com/zkondor/znotch/issues).
74+
75+
## System Requirements
76+
77+
`zNotch` is proven to work flawlessly on `mac OS` "`Monterey`" & "`Ventura`" on Apple Silicon (M1/M2) macbooks.
78+
79+
## Notch Control
80+
81+
### over Menubar
82+
83+
![zNotch in Menubar](media/usage-menubar.png)
84+
85+
### over Command Line
86+
87+
**Show Notch** if still hidden: `open 'xyz.kondor.znotch://v1/manage?action=show'`.
88+
89+
**Hide Notch** if already shown: `open 'xyz.kondor.znotch://v1/manage?action=hide'`.
90+
91+
**Toggle** an opposite (`Notch is visible` -> `Notch is hidden` & `Notch is hidden` -> `Notch is visible`): `open 'xyz.kondor.znotch://v1/manage?action=toggle'`.
92+
93+
### over Raycast Launcher
94+
95+
Using friendly [extension](https://www.raycast.com/zkondor/znotch):
96+
97+
<img src="media/raycast-extension.png" width="400"/>
98+
99+

license.txt

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
Copyright (c) Andrew Sichevoi (and other writing variants of the name depending on a context)
2+
3+
The software is provided "AS IS", without warranty of any kind, express or implied, including but not limited to
4+
the warranties of merchantability, fitness for a particular purpose and non infringement.
5+
In no event shall the authors or copyright holders be liable for any claim, damages or other liability,
6+
whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software
7+
or the use or other dealings in the software.
8+
9+
The software uses & incorporates the following libraries:
10+
- Defaults, (c) Sindre Sorhus
11+
- LaunchAtLogin, (c) Sindre Sorhus
12+
- Preferences, (c) Sindre Sorhus
13+
- SwiftyBeaver, (c) Sebastian Kreutzberger

media/control-way.png

195 KB
Loading

media/download-app-for-macos.png

15.9 KB
Loading

media/download-app-homebrew.png

19.5 KB
Loading

media/raycast-extension.png

365 KB
Loading

media/toggle-cycle.png

336 KB
Loading

media/usage-demo.gif

53.4 KB
Loading

media/usage-menubar.png

53 KB
Loading

privacy.txt

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
# Privacy Policy for zNotch App
2+
3+
No data or personal information is collected by this app.
4+
5+
##### Contact
6+
7+
If you have any questions or suggestions regarding this privacy policy, feel free to [contact me](https://github.com/zkondor/znotch/issues).
8+

0 commit comments

Comments
 (0)