Americano is a macOS menu bar app that prevents your Mac from sleeping — handy during downloads, presentations, or any long-running task.

• Menu Bar Integration — Lives in your menu bar with a single cup icon. Left-click opens the menu, right-click quickly toggles sleep prevention.
• Flexible Durations — Choose from preset durations or create your own custom intervals. Set a default duration for one-click activation.
• Battery Awareness — Automatically stop sleep prevention when battery drops below a threshold, when Low Power Mode activates, or based on charger connection status.
• Notifications — Optional macOS notifications when sleep prevention activates or deactivates.
• Launch at Login — Start automatically when you log in, with optional immediate activation.
• Auto-Update — Built-in Sparkle framework checks for updates automatically (GitHub/Homebrew builds; the App Store version updates through the App Store).
• Onboarding — Welcome window on first launch explains menu bar interaction and quick setup.
• URL Schemes — Control the app programmatically via custom URL schemes.

• Activate (with optional duration): americano:///activate?hours={hours}&minutes={minutes}&seconds={seconds}
  • Example: americano:///activate?hours=1&minutes=30 — Activates for 1 hour 30 minutes
  • Example: americano:///activate — Activates with the default duration
• Deactivate: americano:///deactivate
• Toggle: americano:///toggle

Open from the menu bar menu (⌘,).

• macOS 14.0 and later

Mac App Store:

Homebrew (recommended):

brew install --cask lzhenhong/tap/americano

Manual: download Americano.app.zip from the latest release, unzip, and move Americano.app to /Applications.

The GitHub/Homebrew builds are signed with an Apple Developer ID certificate and notarized by Apple, so they open directly — no Gatekeeper workaround needed.

1. Clone this repo:

   git clone [email protected]:LZhenHong/Americano.git

2. Open Americano.xcodeproj with Xcode.

3. Use your own Team and change the Bundle Identifier.

Americano uses the following Swift Package Manager dependencies:

• StorageMacro — Automatic UserDefaults persistence via @storage macro
• SettingsKit — Settings window framework
• Sparkle — Auto-update framework

Pull requests and issues are welcome! If you encounter any issues or have suggestions for improvement, feel free to submit an issue.

This project is licensed under the MIT License.