Wake up, Neo. Stay awake. Stay out of the way.

A sleek, lightweight, native macOS menu bar utility that prevents your Mac from sleeping during critical tasks. Built from scratch with Swift 6, SwiftUI, and first-party Apple APIs — zero third-party dependencies, zero telemetry, 100% offline.

Quick Start • Interface Preview • Features • User Guide • Smart Watchers • Settings • Architecture • FAQ

Idle Mode	Timed Session (15m)	Watch Downloads	Watch Application
Mac can sleep normally	Live remaining countdown	Auto-sleeps on download finish	Keeps awake while app runs

Have you ever started a large download, long build, or video render, stepped away, and returned to find your Mac went to sleep and halted everything?

WakeUpNeo solves this gracefully:

• 🚀 100% Native & Clean: Pure SwiftUI and Apple IOKit / ProcessInfo power assertions. No Electron bloat, no background telemetry, no memory hogs.
• 🎯 Menu Bar Only: Seamlessly lives in your menu bar. No messy Dock icon, no Cmd+Tab clutter (LSUIElement = YES).
• 📥 Smart Watchers: Automatically detects active browser downloads (.crdownload, .part, .download, .tmp, etc.), monitors target export files, or watches running apps/processes.
• 🔋 Granular Power Control: Keep your system awake while letting the screen sleep to save battery and display life, or enable clamshell protection when the laptop lid is closed.
• ⏱️ Drift-Proof Timers: Computed directly from system clock deadlines — never loses seconds across sleep cycles.

Install WakeUpNeo via Homebrew Cask:

brew install uysalserkan/tap/wakeupneo

Or tap the repository and install:

brew tap uysalserkan/tap
brew install --cask wakeupneo

To upgrade in the future:

brew upgrade --cask wakeupneo

1. Download the latest WakeUpNeo-macOS.zip from GitHub Releases.
2. Unzip and drag WakeUpNeo.app into your /Applications folder.
3. Launch WakeUpNeo — it will appear directly in your top menu bar!

Clone the repository and install directly to /Applications/WakeUpNeo.app:

git clone https://github.com/uysalserkan/WakeUpNeo.git
cd WakeUpNeo
make install

This compiles the release binary, creates the .app bundle, attaches the native app icon and metadata, code-signs with an ad-hoc signature, and places it in your /Applications folder.

git clone https://github.com/uysalserkan/WakeUpNeo.git
cd WakeUpNeo
swift build -c release

The compiled binary will be located in .build/release/WakeUpNeo.

open Package.swift

Select the WakeUpNeo executable scheme and hit Product → Run (Cmd + R).

Click the WakeUpNeo eye icon in your top menu bar:

• Instant Indefinite Mode: Toggle the power button on the top right.
• Quick Preset: Click any duration pill (15m, 30m, 1h, 2h, ∞) to begin a timed session.
• Stop: Click the power button or the active preset button to stop anytime.

Idle / Normal State	Timed Session Active (15m)
Idle popover with Smart Watchers	Active session with live countdown & power toggles

WakeUpNeo gives you granular, independent control over macOS power management:

• 🖥️ Prevent System Sleep (Default: ON): Prevents the CPU, network, and background tasks from sleeping.
• ☀️ Keep Display Awake (Default: OFF): Keeps the display on. Keep this OFF if you want to turn off the monitor or let the screen dim while background tasks run.
• 💻 Prevent Lid Sleep (Default: OFF): Keeps your MacBook awake even with the lid shut (clamshell mode without requiring an external monitor or power adapter).

When downloading large files, games, OS images, or media, you don't need to guess how long it will take:

1. Click the menu bar icon and click Start on Watch Downloads.
2. WakeUpNeo immediately inspects your ~/Downloads folder for in-progress download extensions:
   • Chrome / Chromium: .crdownload
   • Safari: .download package bundles
   • Firefox: .part
   • General & Torrent Clients: .tmp, .partial, .aria2, .!ut, .utpart
   • Custom extensions defined in your Preferences
3. The menu bar displays the active state in real time (Watching for downloads).
4. Once all downloads finish and rename to their final formats, WakeUpNeo automatically releases all power assertions, posts a notification, and allows your Mac to sleep peacefully!

Keep your Mac awake dynamically while long-running jobs, terminal scripts, model training, or background rendering apps execute:

1. Click Watch App… from the Smart Watchers section.
2. Select any active running macOS application (e.g. iTerm2, Xcode, Blender, HandBrake) or enter a custom process ID (PID).
3. WakeUpNeo continuously monitors the process lifecycle without overhead.
4. As soon as the selected app or PID terminates, sleep prevention is automatically released.

If you are rendering a 3D scene, compiling a huge project, or exporting a 4K video:

1. Click Wait for File… and choose your target output file or expected output path.
2. WakeUpNeo holds sleep prevention while the file is being created and written.
3. Once the file stops growing and its modification timestamp stabilizes (configurable settle period, default 2.0s), WakeUpNeo marks it complete, sends a notification, and re-enables sleep.

Open Settings from the menu bar or press Cmd + , to customize WakeUpNeo:

• Launch at Login: Automatically start WakeUpNeo silently when you log into macOS.
• Show Countdown in Menu Bar: Display the live remaining time directly in the menu bar beside the eye icon.
• Notifications: Enable/disable alerts when a session ends or 5 minutes before expiration.
• Default Duration: Pick your default session duration (15m to 8h, or Indefinite).

• Downloads Folder: Change the watched directory (defaults to ~/Downloads).
• Target File Stabilization: Configure the quiet settle duration (0.5s to 30.0s).
• Temporary File Extensions: Add custom comma-separated extensions (e.g. myext, inprogress).
• Completion Notifications: Toggle alerts for download and target file completions.

• Configure default assertion behaviors for system sleep, display sleep, and laptop lid closure.

• Version info, build numbers, and project details.

WakeUpNeo is structured into decoupled, modular Swift targets adhering to strict concurrency and clean architecture principles:

Sources/
├── WakeUpNeoCore/                  # Pure domain & infrastructure (No SwiftUI)
│   ├── Infrastructure/
│   │   ├── PowerAssertion.swift    # IOKit IOPMAssertion RAII wrapper
│   │   └── SleepManager.swift      # Central @Observable @MainActor coordinator
│   ├── Models/
│   │   ├── AppSettings.swift       # Preferences & UserDefaults persistence
│   │   └── SleepMode.swift         # State machine (.off, .indefinite, .timed, .watchingDownloads, .waitingForFile)
│   └── Services/
│       ├── AppLogger.swift         # Unified OSLog subsystem (com.wakeupneo.app)
│       ├── DefaultFileWatcherService.swift  # DispatchSource + Polling file monitor
│       ├── DownloadPatternMatcher.swift     # High-performance extension classifier
│       ├── FileStabilityChecker.swift       # Timestamp & size stabilization algorithm
│       ├── FileWatchingService.swift        # Protocol contracts & Sendable state types
│       ├── LaunchAtLoginService.swift       # SMAppService integration
│       ├── NotificationService.swift       # UNUserNotificationCenter alerts
│       └── SleepPreventionService.swift     # IOKit & ProcessInfo implementations
│
└── WakeUpNeo/                      # Native SwiftUI application shell
    ├── App/
    │   ├── WakeUpNeoApp.swift      # @main MenuBarExtra & Settings scenes
    │   └── AppEnvironment.swift    # App-level dependency container
    ├── Features/
    │   ├── MenuBar/
    │   │   ├── MenuBarView.swift   # Main popover interface
    │   │   ├── MenuBarIcon.swift   # Menu bar status icon
    │   │   └── CountdownView.swift # Real-time drift-free countdown
    │   └── Settings/
    │       ├── SettingsView.swift  # TabView settings window
    │       ├── GeneralSettingsView.swift
    │       ├── MonitoringSettingsView.swift
    │       ├── PowerSettingsView.swift
    │       └── AboutView.swift
    └── Resources/
        ├── AppIcon.icns            # macOS native application icon
        ├── WakeUpNeo-Info.plist    # LSUIElement=YES (hides Dock & Cmd+Tab)
        └── WakeUpNeo.entitlements  # Sandboxing & power entitlements

WakeUpNeo features a 4-Tier Test Suite with 203 automated tests ensuring 100% reliability, zero memory leaks, and strict concurrency safety:

# Run entire test suite
swift test

See TEST_READY.md and TEST_INFRA.md for full test reports and architectural details.

defaults delete com.wakeupneo.app

Contributions are welcome! Please check out CONTRIBUTING.md for guidelines on code standards, Swift 6 strict concurrency, and how to run tests.

WakeUpNeo is open-source software licensed under the MIT License.