Weakup

Testing scope: The coverage badge reflects WeakupCore unit and integration tests. XCUITest source files are present, but UI tests are not currently executed by the Swift Package Manager CI workflow.

A high-performance, lightweight macOS utility to prevent your Mac from sleeping.

• One-Toggle Control - Enable/disable sleep prevention with a single click
• Turn Off Display - Switch off the display immediately while keeping your Mac and background tasks running
• Menu Bar App - Lives in menu bar, no dock clutter
• Timer Mode - Set auto-shutdown timer (15min, 30min, 1hr, 2hrs, 3hrs, or custom duration up to 24 hours)
• Countdown in Menu Bar - Optional timer countdown next to the status icon
• Visual Status - Clear filled/empty icon indicator with multiple icon styles
• Keyboard Shortcut - Cmd + Ctrl + 0 to toggle anywhere
• Hotkey Conflict Detection - Warns about common shortcut conflicts and suggests alternatives
• Native Integration - Uses macOS IOPMAssertion APIs to prevent idle and display sleep
• Dark/Light Theme - Supports system theme, light mode, and dark mode
• Sound Feedback - Optional audio feedback when toggling
• Icon Customization - Choose from Power, Bolt, Coffee, Moon, or Eye icons
• Multi-Language Support - 8 languages with real-time switching
• Launch at Login - Optional startup at login with error handling
• Timer Expiry Notifications - Optional notification when the timer ends
• Onboarding - First-launch walkthrough
• SwiftUI + AppKit - Modern, clean codebase

Building locally is currently the only supported installation method. To build the latest stable version:

# Clone the current stable tag
git clone --branch v1.1.0 --depth 1 https://github.com/Zzzode/weakup.git
cd weakup

# Build the app
./build.sh

# Run
open Weakup.app

GitHub Releases include a versioned Weakup-x.y.z-source.tar.gz archive built from the exact release commit.

The DMG and ZIP attached to v1.0.2 are legacy unsigned artifacts and are not supported for installation. Weakup has no Developer ID signature or Apple notarization, so those downloads may fail Gatekeeper and signature validation. Weakup is also not available from the official Homebrew Cask repository.

• macOS 13 or later
• Xcode toolchain and Swift 6.2.3 or later (.swift-version records the minimum)

1. Click the menu bar icon to toggle sleep prevention
2. Right-click and choose "Turn Off Display" to keep your Mac running with the display off
3. Right-click or select "Settings" to access options
4. Use Cmd + Ctrl + 0 keyboard shortcut to toggle from anywhere
5. Switch language instantly in the settings panel

• Timer Mode - Enable automatic shutdown after a set duration
• Duration - Choose from preset times or set a custom duration (up to 24 hours)
• Theme - System, Light, or Dark
• Sound Feedback - Toggle audio feedback on/off
• Notifications - Toggle timer expiry notifications
• Menu Bar Countdown - Show remaining timer next to the icon
• Icon Style - Choose your preferred menu bar icon
• Language - Switch between 8 supported languages
• Launch at Login - Start Weakup when you sign in
• Hotkey - Customize shortcut and resolve conflicts

• Schedule-based activation (time-of-day rules)
• Menu bar widget for quick stats
• Shortcuts app integration

The current stable release is v1.1.0. See CHANGELOG.md for shipped changes.

• Architecture - System architecture overview
• Development - Setup and development workflow
• Testing - Testing guidelines
• Translations - Guide for adding new languages
• Code Signing - Code signing and notarization guide
• Homebrew - Homebrew installation guide
• Privacy - Privacy policy

Contributions are welcome! Please see CONTRIBUTING.md for details.

English | 中文

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

• Built with Swift
• UI framework: SwiftUI
• Sleep prevention: IOPMAssertion