{"id":50793939,"url":"https://github.com/abhinavv-007/notchly","last_synced_at":"2026-06-12T13:01:02.608Z","repository":{"id":356763210,"uuid":"1233179163","full_name":"Abhinavv-007/Notchly","owner":"Abhinavv-007","description":"macOS notch utility — media live activity, file shelf, mail pill, web notifications, sliding pills. SwiftUI + AppKit.","archived":false,"fork":false,"pushed_at":"2026-05-09T17:08:11.000Z","size":5293,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-09T17:37:14.334Z","etag":null,"topics":["appkit","macbook","macos","menubar","notch","productivity","swiftui"],"latest_commit_sha":null,"homepage":"https://abhnv.in","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Abhinavv-007.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":"docs/ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["Alexander5015","iamharshdev"],"ko-fi":"alexander5015"}},"created_at":"2026-05-08T17:15:40.000Z","updated_at":"2026-05-09T17:08:15.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Abhinavv-007/Notchly","commit_stats":null,"previous_names":["abhinavv-007/notchly"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/Abhinavv-007/Notchly","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abhinavv-007%2FNotchly","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abhinavv-007%2FNotchly/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abhinavv-007%2FNotchly/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abhinavv-007%2FNotchly/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Abhinavv-007","download_url":"https://codeload.github.com/Abhinavv-007/Notchly/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abhinavv-007%2FNotchly/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34245218,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-12T02:00:06.859Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["appkit","macbook","macos","menubar","notch","productivity","swiftui"],"created_at":"2026-06-12T13:01:01.457Z","updated_at":"2026-06-12T13:01:02.590Z","avatar_url":"https://github.com/Abhinavv-007.png","language":"Swift","funding_links":["https://github.com/sponsors/Alexander5015","https://github.com/sponsors/iamharshdev","alexander5015"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"Notchly/Assets.xcassets/logo2.imageset/Notchly icon.png\" alt=\"Notchly\" width=\"160\" /\u003e\n\n  # Notchly\n\n  **Turn your MacBook notch into a control surface.**\n\n  Media · File shelf · Mail · Web notifications — all in the space you already ignore.\n\n  \u003cp\u003e\n    \u003cimg src=\"https://img.shields.io/badge/macOS-14%20Sonoma%2B-000000?style=for-the-badge\u0026logo=apple\" alt=\"macOS 14+\" /\u003e\n    \u003cimg src=\"https://img.shields.io/badge/SwiftUI-Native-FA7343?style=for-the-badge\u0026logo=swift\" alt=\"SwiftUI\" /\u003e\n    \u003cimg src=\"https://img.shields.io/badge/build-passing-2ea44f?style=for-the-badge\" alt=\"build\" /\u003e\n    \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-Apache%202.0-blue?style=for-the-badge\" alt=\"license\" /\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\n  \u003cp\u003e\n    \u003ca href=\"https://github.com/Abhinavv-007/Notchly/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/badge/⬇%20Download%20Notchly-Latest%20Release-1f6feb?style=for-the-badge\" alt=\"Download\" height=\"44\" /\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\n  \u003csub\u003eBy \u003ca href=\"https://abhnv.in\"\u003e\u003cb\u003eAbhinav Raj\u003c/b\u003e\u003c/a\u003e · \u003ca href=\"https://abhnv.me\"\u003eabhnv.me\u003c/a\u003e · \u003ca href=\"https://modih.in\"\u003emodih.in\u003c/a\u003e · \u003ca href=\"https://clex.in\"\u003eclex.in\u003c/a\u003e\u003c/sub\u003e\n\u003c/div\u003e\n\n---\n\n## Why Notchly\n\nYour MacBook notch is dead space. Notchly fills it with the things you actually reach for:\n\n- **🎵 Media live activity** — album art, scrubber, controls. Pill widens when music plays, returns when it stops.\n- **📁 File shelf** — drag a file onto the notch, it lives there until you need it. Quick Look, share, drag back out.\n- **✉️ Modih Mail** — a temporary inbox (powered by [modih.in](https://modih.in)) one click away, left of the notch.\n- **🔔 Web notifications** — Discord, Telegram, Instagram, WhatsApp, Gmail, Reddit, Slack — one bell, right of the notch.\n- **🌗 Live HUD** — volume, brightness, battery, mic, downloads — reskinned for the notch.\n- **📅 Calendar + reminders** — one tap to today's agenda.\n- **⚙️ Notch utility** — sliding pills, themed visualizer, hover gestures, multi-display.\n\n## Sliding Pills\n\nWhen music plays, the closed notch widens for the live activity. Notchly adds two flanking pills — envelope (left) for mail, bell (right) for notifications. They slide outward with the pill and return when music stops. No janky overlap, no fixed-position chrome.\n\n```\n   ┌──────────┐                      ┌─ envelope ─┐  ┌─── pill ────┐  ┌─ bell ─┐\n   │   notch  │   ←  music starts  →\n   └──────────┘                      └────────────┘  └─────────────┘  └────────┘\n```\n\n## Quick install\n\n1. Download `Notchly.dmg` from the [latest release](https://github.com/Abhinavv-007/Notchly/releases/latest).\n2. Open it and drag **Notchly** into **Applications**.\n3. First launch: Right-click the app → **Open** (it's unsigned; macOS asks once).\n4. Grant Accessibility + Calendar + Camera permissions when prompted.\n\nDetailed steps in [INSTALL.md](INSTALL.md).\n\n## Web notifications setup\n\nNotchly's bell pill talks to web apps through embedded WebKit sessions. Sign in once per app:\n\n1. Open **Settings** → **Add-Ons** → **Web Notifications**.\n2. Pick an app (Gmail, Slack, etc.) → **Sign in**.\n3. Session stays warm; new notifications surface as previews around the notch.\n\nBackground polling is **off by default** to keep energy use low. Toggle it in Add-Ons settings if you want it on.\n\n## Modih Mail\n\nThe envelope pill opens a [modih.in](https://modih.in) temporary inbox. Free addresses work without a key — paste an API key in **Settings → Add-Ons → Modih Mail** for the developer plan with no expiry.\n\n## Build from source\n\n```bash\ngit clone https://github.com/Abhinavv-007/Notchly.git\ncd Notchly\nopen Notchly.xcodeproj\n```\n\nOr terminal-only:\n\n```bash\nxcodebuild -project Notchly.xcodeproj -scheme Notchly -configuration Release \\\n  build CODE_SIGNING_ALLOWED=NO\n```\n\nOutput `.app` lands at `~/Library/Developer/Xcode/DerivedData/Notchly-*/Build/Products/Release/Notchly.app`.\n\n## Stack\n\n| | |\n|---|---|\n| **UI** | SwiftUI + AppKit |\n| **Web** | WebKit |\n| **Media** | MediaRemote + Spotify / Apple Music / YouTube Music adapters |\n| **Updater** | Sparkle |\n| **Storage** | `Defaults` (Sindre) + Keychain |\n| **Calendar** | EventKit |\n\n## Status\n\n- macOS 14 Sonoma+\n- M-series + Intel\n- Multi-display (notch detection per screen)\n- Unsigned dev builds; codesigning + notarization on the roadmap.\n\n## Roadmap\n\n- Apple Developer ID signing + notarization\n- Auto-update via Sparkle (appcast at `abhnv.in/notchly`)\n- More web notification adapters\n- Localization expansion (Crowdin-driven)\n\n## Credits\n\nNotchly stands on the shoulders of the open-source [`boring.notch`](https://github.com/TheBoredTeam/boring.notch) — thanks to the original community for the notch-utility groundwork. Notchly is a separate fork by Abhinav Raj with the AddOns layer, branding, and bug fixes layered on top.\n\n## License\n\nApache 2.0 — see [LICENSE](LICENSE).\n\nThird-party notices in [THIRD_PARTY_LICENSES](THIRD_PARTY_LICENSES).\n\n## Author\n\n**Abhinav Raj** · [abhnv.in](https://abhnv.in) · [abhnv.me](https://abhnv.me) · [linkedin.com/in/abhnv07](https://www.linkedin.com/in/abhnv07/)\n\nOther projects: [modih.in](https://modih.in) · [clex.in](https://clex.in)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabhinavv-007%2Fnotchly","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabhinavv-007%2Fnotchly","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabhinavv-007%2Fnotchly/lists"}