Documentation

Getting NotchHub up and running takes less than a minute.

Download & Install

1. 1
   Download NotchHub

   Click the download button on our homepage or download directly here.

2. 2
   Open the DMG file

   Double-click the downloaded NotchHub.dmg file to mount it.

3. 3
   Drag to Applications

   Drag the NotchHub icon to your Applications folder.

4. 4
   Launch NotchHub

   Open NotchHub from your Applications folder or Spotlight (⌘ + Space, type "NotchHub").

5. 5
   Grant Permissions

   Follow the prompts to grant necessary permissions. See the Permissions section for details.

Updating NotchHub

NotchHub checks for updates automatically. When an update is available:

• You'll see a notification in your Dynamic Island
• Click the notification or go to Settings → Updates
• Click "Download & Install"

You can also manually check for updates in Settings → About → Check for Updates.

Uninstalling

To uninstall NotchHub:

1. Quit NotchHub (right-click menu bar icon → Quit)
2. Drag NotchHub from Applications to Trash
3. Optionally, remove preferences: ~/Library/Preferences/app.notchhub.NotchHub.plist

Here's a 2-minute guide to get you up and running with the core features.

Your First Live Activity

Once NotchHub is running, try playing some music in Apple Music or Spotify. You'll see the currently playing track appear in your notch with album artwork and playback controls.

Essential Gestures

Access Settings

Click the NotchHub icon in your menu bar to access settings and preferences.

Or use the keyboard shortcut: ⌘ + , (when NotchHub is focused)

Minimum Requirements

Compatible Macs

Macs with Notch (Recommended):

• MacBook Pro 14" (2021, 2023)
• MacBook Pro 16" (2021, 2023)
• MacBook Air M2 (2022)
• MacBook Air M3 (2024)

Macs without Notch:

NotchHub also works on Macs without a notch! It displays as a floating "island" at the top center of your screen. Compatible with:

• MacBook Air M1 (2020)
• MacBook Pro 13" (2020+)
• iMac (2020+)
• Mac Mini / Mac Studio / Mac Pro (with external display)

NotchHub requires certain macOS permissions to function properly. Here's what each permission does and why it's needed.

Live Activities are real-time updates that appear in your Dynamic Island. They provide glanceable information without interrupting your workflow.

Available Live Activities

Configuring Live Activities

You can enable or disable specific Live Activities in Settings:

Priority Order

When multiple activities are active, NotchHub shows them in priority order:

1. Phone Calls (highest priority)
2. Timers (when less than 1 minute remaining)
3. Active Downloads
4. Music (lowest priority, always available)

You can customize this order in Settings → Live Activities → Priority.

Control your music without switching apps. NotchHub integrates with all major media players.

Supported Apps

• Apple Music
• Spotify
• YouTube Music (in browser)
• Amazon Music
• Tidal
• Any app using macOS Now Playing APIs

Gesture Controls

Gesture	Action
Tap	Play / Pause
Swipe Right	Next Track
Swipe Left	Previous Track
Long Press	Expand to full player
Two-finger Swipe Up/Down	Volume Up / Down

Expanded View

Long-press on the music activity to expand it. The expanded view shows:

• Full album artwork
• Track progress bar (draggable)
• Shuffle & repeat controls
• Like/dislike buttons (Spotify)
• AirPlay device selector

Power users can control NotchHub entirely with keyboard shortcuts.

Global Shortcuts

These work from any app:

Shortcut	Action
⌃ + ⌥ + Space	Toggle island visibility
⌃ + ⌥ + M	Play / Pause media
⌃ + ⌥ + →	Next track
⌃ + ⌥ + ←	Previous track
⌃ + ⌥ + N	Dismiss current notification
⌃ + ⌥ + T	Start/stop timer

Customizing Shortcuts

All shortcuts can be customized:

Having issues? Here are solutions to common problems.

Reset to Defaults

If all else fails, you can reset NotchHub to factory settings:

Or manually delete preferences:

Still Need Help?

If your issue isn't resolved, please contact our support team. Include:

• macOS version
• NotchHub version
• Mac model
• Steps to reproduce the issue
• Screenshots if applicable

We're here to help! Reach out through any of these channels: