whatisgithub

What is notchland?

sciencelabwork/notchland — explained in plain English

Analysis updated 2026-05-18

12SwiftAudience · developerComplexity · 2/5LicenseSetup · moderate

In one sentence

A macOS app that turns the MacBook notch into a live display for media controls, AirDrop, system alerts, and calendar peeks.

Mindmap

mindmap
  root((NotchLand))
    What it does
      Lives in MacBook notch
      Follows Spaces and fullscreen
      Apple style animations
    Tech stack
      Swift
      SwiftUI and AppKit
      Xcode project
    Use cases
      Media playback controls
      AirDrop drop zone
      Calendar countdown
      Battery and Focus alerts
    Audience
      MacBook notch owners
      Swift developers
      Open source contributors

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

See live media playback controls and artwork right in the MacBook notch area.

USE CASE 2

Drag a file near the notch to open an AirDrop sharing drop zone.

USE CASE 3

Get a quick glance at upcoming calendar events with a countdown timer.

USE CASE 4

See volume, brightness, battery, and Focus mode changes as notch overlays instead of menu bar popups.

What is it built with?

SwiftSwiftUIAppKitXcode

How does it compare?

sciencelabwork/notchlandamethystsoft/keyringaccesskageroumado/refrax-browser
Stars121212
LanguageSwiftSwiftSwift
Setup difficultymoderateeasyhard
Complexity2/52/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires macOS 26.3+ and Xcode 26.4+ to build from source, dependencies resolve through Xcode, not Swift Package Manager.

Free to use, modify, and distribute, including commercially, as long as you keep the license and attribution notices.

So what is it?

NotchLand is a macOS app that turns the notch at the top of a MacBook screen into a small live display area instead of leaving it as empty black space. Rather than living in the menu bar like most utilities, it anchors itself right at the notch and stays there as you switch desktops, move between Spaces, or go full screen, using the same smooth, spring style animations that Apple's own system interface uses. The goal stated by the developer is for it to feel like a feature built into macOS rather than a separate app running alongside it. The app stays hidden until there is something worth showing, then expands to display it before collapsing again. Features include live media controls and artwork for whatever is playing, a drop zone that appears when you drag a file near the notch to AirDrop it, and clean overlays for volume and brightness changes. It also shows charging and low battery alerts, a notice when Focus mode changes, and a peek at your next calendar event with a countdown. When you lock your Mac it shows a padlock animation, and unlocking brings up a welcome back card with how long you were away, your battery level, and your next event. A guided first launch walkthrough introduces these features and asks for Calendar and Accessibility permissions step by step, with each step skippable. NotchLand is built natively with SwiftUI and AppKit and runs as a background accessory app with no Dock icon. It requires macOS 26.3 or later, and building from source requires Xcode 26.4 or later on a MacBook with a display notch. There is no Swift Package Manager manifest, since dependencies such as Sparkle for updates and Lottie for animations resolve through Xcode directly. It ships as a standard Xcode project that can be built from the command line or opened in Xcode, and it includes its own test suite using Swift Testing. The codebase is organized so that each feature, such as battery alerts or the AirDrop drop target, publishes its own state to a single priority ordered view that decides what to show in the notch at any moment, which the README says makes it straightforward to add new features without touching existing ones. NotchLand is released under the Apache License 2.0, and the project is open to contributions including bug reports, fixes, and documentation.

Copy-paste prompts

Prompt 1
Help me build NotchLand from source in Xcode and explain what an accessory app with no Dock icon means on macOS.
Prompt 2
Explain how NotchLand's priority ordered switch in FloatingNotchView decides which feature to show in the notch.
Prompt 3
Walk me through adding a new notch feature to NotchLand following its controller and branchKey pattern.
Prompt 4
What Calendar and Accessibility permissions does NotchLand request, and why would a notch utility need them?

Frequently asked questions

What is notchland?

A macOS app that turns the MacBook notch into a live display for media controls, AirDrop, system alerts, and calendar peeks.

What language is notchland written in?

Mainly Swift. The stack also includes Swift, SwiftUI, AppKit.

What license does notchland use?

Free to use, modify, and distribute, including commercially, as long as you keep the license and attribution notices.

How hard is notchland to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is notchland for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.