|
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 | + |
| 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 | + |
| 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 | + |
0 commit comments