Skip to content

iDams/NotchTerminal

Repository files navigation

NotchTerminal

License: MIT macOS Version

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

NotchTerminal

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

Coming soon


Build from Source

git clone https://github.com/marcoastorj/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


Support

Buy Me a Coffee

Buy Me a Coffee QR


License

MIT © 2026 Marco Astorga González

About

A macOS terminal that lives in the notch, with floating windows, quick actions, and Metal effects.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages