<p align="center"> <img src="docs/images/hero-en.png" alt="NotchMate: a panel under the MacBook notch with a companion, music and the next meeting" width="100%"> </p> <p align="center"> <a href="https://github.com/aleksandr-developer1/notchmate/releases"><img src="https://img.shields.io/github/v/release/aleksandr-developer1/notchmate?include_prereleases&label=release&color=FF9F0A" alt="Release"></a> <a href="https://github.com/aleksandr-developer1/notchmate/releases"><img src="https://img.shields.io/github/downloads/aleksandr-developer1/notchmate/total?color=2fb3ff" alt="Downloads"></a> <img src="https://img.shields.io/badge/macOS-14%2B-000?logo=apple&logoColor=white" alt="macOS 14+"> <img src="https://img.shields.io/badge/Swift-5.10-F05138?logo=swift&logoColor=white" alt="Swift 5.10"> <img src="https://img.shields.io/badge/Apple%20Silicon-arm64-555" alt="Apple Silicon"> <img src="https://img.shields.io/badge/languages-8-7b5cff" alt="8 languages"> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-3DA639" alt="MIT"></a> <a href="https://github.com/aleksandr-developer1/notchmate/stargazers"><img src="https://img.shields.io/github/stars/aleksandr-developer1/notchmate?style=social" alt="Stars"></a> </p> <p align="center"><a href="README.ru.md">Русский</a> · <b>English</b></p>

NotchMate

[!WARNING] Beta. NotchMate is used every day, but it is still being polished: expect bugs, and the UI and settings will change. If something breaks, please open an issue.

Turn the dead space around your MacBook notch into a living companion. Hover the notch and a panel slides out with your music, notes, today's meetings, Jira tasks, call recording, health data and an AI chat — plus a tiny pixel pet that reacts to what you're doing. Free, open source, and your data stays on your Mac.

<p align="center"> <a href="https://github.com/aleksandr-developer1/notchmate/releases/latest"><img src="https://img.shields.io/badge/Download_for_macOS-arm64-000?style=for-the-badge&logo=apple&logoColor=white" alt="Download for macOS"></a> </p>

🌍 Speaks your language: English, Русский, Deutsch, Español, Français, Português (Brasil), 简体中文 and 日本語. NotchMate follows the system language; you can pick another one in Settings → General → Language.

Meet your companion

NotchMate has a living pixel face. It dances to your music, gets serious while you focus, reacts to files and charging, and reminds you to drink water. Almost 40 animations — these are real frames from the app:

<p align="center"> <img src="docs/images/companion.gif" alt="Companion animations: happy, music, love, focus, sleepy, surprised, dance, zen" width="720"> </p>

<a id="see-it-in-action"></a> <img src="docs/images/section-look-en.png" alt="See it in action" width="100%">

Hover the notch and the panel slides down. Tabs: Companion, Music, Health, Work, Notes and Shelf.

<table> <tr> <td width="50%"><img src="docs/images/assistant-en.png" alt="Companion tab: day timeline, the companion's note, what needs attention and a question field"><br><b>Companion</b>: a timeline of meetings and reminders, what needs your attention, ask the companion about your day</td> <td width="50%"><img src="docs/images/music-en.png" alt="Music tab: artwork, seeking, volume, focus timer and daily note"><br><b>Music</b>: player with seeking and volume, plus a focus timer and today's note</td> </tr> <tr> <td width="50%"><img src="docs/images/notes-en.png" alt="Notes tab: quick capture, search, pinned notes and a preview"><br><b>Notes</b>: quick capture, search, pinned notes and a preview with checkboxes</td> <td width="50%"><img src="docs/images/work-en.png" alt="Work → Jira tab: the issue in progress with a timer and the issue list"><br><b>Work</b>: the issue in progress with a timer and worklogs, your Jira issues</td> </tr> <tr> <td width="50%"><img src="docs/images/health-en.png" alt="Health tab: Body Battery, stress, today's chart, sleep and heart rate"><br><b>Health</b>: Body Battery, stress, today's chart and breathing</td> <td valign="middle" align="center">_{Illustrations follow the app's real layout;<br>the data in them is made up.}</td> </tr> </table>

<a id="features"></a> <img src="docs/images/section-features-en.png" alt="Features" width="100%">

• Companion — a living face under the notch. Reacts to music, focus, notes, files and charging; reminds you to drink water and stretch. Click to interact, double-click for today's tasks and stats.
• Music — Yandex Music, Spotify, Apple Music and the browser via Now Playing: artwork, seeking, volume, colors from the cover.
• Notes — quick capture into your daily note, search, previews with checkboxes, pinned notes. Obsidian or Apple Notes.
• Calendar & reminders — upcoming meetings and today's to-dos.
• Calls — recording, on-device transcription and meeting minutes.
• Jira — issues in progress, a timer and worklogs.
• Git — the state of the repository you're working in.
• AI chat — Claude Code, Codex, OpenAI with your key, or your own OpenAI-compatible server (e.g. Ollama).
• Agents — see when Claude Code is waiting for you; agents get NotchMate's tools over MCP.
• Health — stress, Body Battery and sleep from Garmin Connect, breathing exercises.
• Shelf for files, clipboard history (no passwords) and a focus timer.

Shortcuts: ⌃⌥N — open, ⌃⌥M — quick note, ⌘1–6 — tabs, Esc — close.

<a id="install"></a> <img src="docs/images/section-install-en.png" alt="Install" width="100%">

1. Download NotchMate-…-arm64.zip from the latest release.
2. Unzip it and drag NotchMate into Applications.
3. On first launch macOS will say it can't verify the developer — the app isn't notarized by Apple yet. Open System Settings → Privacy & Security and click Open Anyway next to NotchMate. Or run in Terminal:

   xattr -dr com.apple.quarantine /Applications/NotchMate.app
   

4. Grant the permissions NotchMate asks for — without them only the related feature is off.

After installing a new version macOS may ask for permissions again: releases are signed without a developer certificate.

Requirements

• macOS 14 Sonoma or later, Apple Silicon.
• A MacBook with a notch is ideal; on other Macs the panel sits at the top of the screen.
• To build: Xcode or Command Line Tools with Swift 5.10+.

<a id="build"></a> <img src="docs/images/section-build-en.png" alt="Build from source" width="100%">

git clone --recursive https://github.com/aleksandr-developer1/notchmate.git
cd notchmate
./build.sh            # builds build/NotchMate.app
./build.sh install    # and installs it to /Applications, then launches it

If you cloned without --recursive, build.sh fetches the Vendor/mediaremote-adapter submodule itself.

Signing. macOS ties granted permissions (Accessibility, Automation, microphone and others) to the app's signature. build.sh uses the first Apple Development / Developer ID certificate in your keychain; without one it signs ad hoc, and permissions have to be granted again after every rebuild. Pick a certificate explicitly with SIGN_ID="<name or SHA-1>" ./build.sh.

Permissions

On first launch NotchMate shows which permissions it needs and why. All of them are optional — without one, only the related feature is off:

| Permission | Used for | |---|---| | Accessibility | hotkeys, the current window and repository | | Automation | Notes, browser tabs, the player | | Microphone & screen recording | recording calls | | Speech recognition | on-device transcription | | Calendars, Reminders | today's meetings and to-dos |

<a id="privacy"></a> <img src="docs/images/section-privacy-en.png" alt="Privacy" width="100%">

• All data stays local: ~/Library/Application Support/NotchMate and macOS preferences.
• Jira tokens and AI keys are stored in ~/Library/Application Support/NotchMate/secrets.json, readable only by your user account (mode 600). The system Keychain isn't used so macOS doesn't prompt for access after every rebuild.
• Calls are transcribed on your Mac.
• AI requests go only to the provider you pick in the settings.
• Clipboard history skips passwords and content marked as confidential.

<a id="claude-code"></a> <img src="docs/images/section-agents-en.png" alt="Claude Code and Codex" width="100%">

NotchMate works as an MCP server for Claude Code and Codex and receives their hooks to show when an agent is waiting for you. Connect everything with one button in Settings → Integrations, or add the MCP server by hand:

claude mcp add --scope user notchmate -- /Applications/NotchMate.app/Contents/MacOS/NotchMate --mcp

Project layout

Sources/NotchMate/  source code, one folder per feature (Media, Jira, Calls, AI…)
Resources/          Info.plist, icon, companion animations, Garmin sync script
Vendor/             mediaremote-adapter (git submodule)
docs/images/        README images

License

MIT. Third-party components and their licenses are listed in THIRD_PARTY_NOTICES.md.

NotchMate uses the private MediaRemote framework, so it can't ship on the Mac App Store, and a macOS update may break the Music block.

---

<p align="center">If NotchMate makes your day a little nicer, please ⭐ star the repo — it really helps the project grow.<br> Bugs and ideas go to <a href="https://github.com/aleksandr-developer1/notchmate/issues">issues</a>, questions to <a href="https://github.com/aleksandr-developer1/notchmate/discussions">discussions</a>. Want to help with code? See <a href="CONTRIBUTING.md">CONTRIBUTING</a>.</p>