NotchTerminal

English | Español | 日本語 | 简体中文 | Français

A drop-down terminal for macOS that lives in your notch. Fast, always accessible, and stays out of your way.

---

Demo

demo1.mp4

demo2.mp4

---

Features

• Notch Integration: Hover to expand. Works on all Macs (even those without a physical notch) and across multiple displays.
• Menu Bar Access: A menu bar item is available for quick access to core functions and settings.
• Session Management: SwiftData persistence automatically restores your window positions, sizes, and states across launches.
• Window Management: Compact mode, always-on-top, and a drag-and-drop system that supports paths.
• Built-in Tools:
  • Active Ports: View listening TCP ports and kill processes directly.
  • Storage Analyzer: Quickly scan and clean up node_modules, DerivedData, caches, and logs.

Experimental Features

NotchTerminal includes an experimental settings tab featuring:

• CRT Filter: A retro CRT terminal overlay using Metal shaders.
• Fake Notch Glow: Simulates a glowing ambient light coming from the notch (Cyberpunk theme, etc).
• Startup Orb: A visual indicator during app launch.
• Drag-to-Dock: Adjust the magnetic sensitivity when dragging terminal windows near the notch.

Keyboard Shortcuts

Shortcut	Action
⌘C / ⌘V / ⌘A	Copy / Paste / Select All
⌘K	Clear buffer
⌘F	Search
⌘W	Close session
⌘+ / ⌘-	Adjust font size

---

Screenshots

---

Requirements

• macOS 14+
• Xcode 16+ (to build from source)

---

Installation

Homebrew

brew tap idams/notchterminal
brew install --cask notchterminal

Direct Download

1. Open the latest release on GitHub.
2. Download NotchTerminal-<version>.zip.
3. Unzip the file.
4. Move NotchTerminal.app to /Applications.

Releases:

• https://github.com/iDams/NotchTerminal/releases

---

Build from Source

git clone https://github.com/iDams/NotchTerminal.git
cd NotchTerminal

Open NotchTerminal.xcodeproj and run the NotchTerminal scheme.

Local Code Signing: The repository does not include a personal Apple DEVELOPMENT_TEAM. To build locally:

1. Copy Config/Signing.local.example.xcconfig to Config/Signing.local.xcconfig
2. Add your Apple Developer team ID.
3. Keep this file local (it's in .gitignore).

---

Documentation & Links

• Documentation Index
• Testing Guide
• Localization
• Contributing Guidelines
• Third-Party Notices

---

Feedback and Bugs

Found a bug, want to request a feature, or hit an installation issue?

• Open an issue: https://github.com/iDams/NotchTerminal/issues

---

Support

---

Brand Notice

Some screenshots, icons, and references may mention third-party tools or services such as OpenAI, Claude, Copilot, or similar products to show workflows or interoperability.

Those names, logos, and marks belong to their respective owners. They are used only for identification and descriptive reference inside the app, website, documentation, or promotional visuals. NotchTerminal is not affiliated with, endorsed by, or sponsored by those companies unless explicitly stated otherwise.

---

License

MIT © 2026 Marco Astorga González