Skip to content

Settings Guide

DinanathDash edited this page Jul 30, 2026 · 6 revisions

Open Settings from the menu bar dropdown (⌘,) or by clicking "Settings" in the menu.

Settings Window

General

Startup

  • Launch at login — Start Stasis automatically when you log in to your Mac.

Menu Bar Icon

  • Show battery percentage — Display the current percentage next to the battery icon in the menu bar.
  • Show battery state — Show a charging bolt or plug icon on the battery to indicate charging state.

Language

  • App language — Choose between System Default and 17 supported languages (including English, Deutsch, Español, Français, Italiano, Nederlands, Português Brasil/Portugal, Slovenčina, Slovenščina, Tiếng Việt, Türkçe, Русский, 简体中文, 繁體中文, 日本語, and 한국어). Selecting a new language automatically restarts Stasis to apply localized tokens.

Helper Daemon

  • Daemon Status — Displays whether com.dinanathdash.stasis.charging-helper is active, connected, or needs approval.
  • Reinstall / Remove Daemon — Reinstall the privileged helper daemon if permissions are out of sync, or uninstall it completely.

Notifications

  • Disable all notifications — Turn off all Stasis notifications.
  • Charging status changed — Get notified when charging starts or stops (e.g., "Charging Paused — Battery has reached the charge limit of 80%").
  • Calibration guidance notifications — Receive step-by-step guidance during battery calibration cycles.

Dashboard

Controls which metrics appear in the menu bar dropdown. Toggle each one on or off depending on what you want to see.

Status

  • Power source
  • Time until discharge / time to full
  • Uptime
  • Battery mode (Charging / Plugged In / Discharging)
  • Apps using significant energy — Show running applications consuming significant battery power in real time.

Battery Health

  • Cycle count
  • Health percentage
  • Temperature

Power

  • Battery power metrics (voltage, current, wattage)
  • Adapter power metrics (voltage, current, wattage)
  • Two-Decimal Power Precision — Toggle between standard precision and high precision (0.01W / 0.01A) for power readouts.

Visuals

  • Power distribution diagram (Sankey flow visualization)

Charging

This tab only appears in full when "Manage Charging" is enabled. Enabling it installs a privileged helper daemon — macOS will ask you to approve it in System Settings → Login Items.

Charge Management

  • Manage charging — Master toggle. Enables charge limit enforcement.
  • Charge limit (50–100%) — The maximum level the battery will charge to.

Discharge

  • Automatic discharge — Force the system to run on battery when plugged in above the limit. Requires adapter control support.

Sleep Prevention

  • Disable sleep until charge limit — Keep the Mac awake (display off) while charging toward the limit. Sleep re-enables once the limit is reached or the adapter is disconnected.

Sailing Mode

  • Enable sailing mode — Avoid micro-charging by allowing the battery to drift within a range before resuming charging.
  • Threshold below limit (1–20%) — How far below the limit the battery can drop before charging resumes.
  • Charging resumes at — Shows the calculated resume percentage (limit minus threshold).

Heat Protection

  • Enable heat protection — Pause charging when battery temperature exceeds the threshold.
  • Temperature limit (30–50°C) — The temperature at which charging pauses.

MagSafe LED Control

Only visible on MacBooks with MagSafe.

  • Manage MagSafe LED — Override the LED to reflect Stasis's charging state (green = at limit, orange = charging).
  • LED during heat protection — Choose the LED behavior when heat protection is active: Off, Green, Orange, Blinking Orange Slow, or Blinking Orange Fast.

Calibration

The Calibration tab allows you to run an interactive cycle to recalibrate your battery gauge and SMC voltage sensors.

Battery Calibration Service

  • Start Calibration — Initiates a guided 3-stage calibration cycle (Discharge to 15% → Recharge to 100% → Rest at 100%).
  • Cancel Calibration — Immediately stops an active calibration cycle and restores your standard charging limit and Sailing Mode settings.
  • Learn more in the Battery Calibration Guide.

Notch HUD

For MacBooks with a hardware camera notch (or simulated notch mode).

Notch Alerts & Display

  • Enable Notch HUD — Display sleek, animated status pills around the notch during charging transitions and limit alerts.
  • Elevate Above Lock Screen — Powered by TopWindowElevator, keeping Notch HUD notifications cleanly visible above macOS lock screens and full-screen applications.

Advanced

  • Use hardware percentage — Use the raw battery percentage from the firmware instead of the macOS-calibrated value. See Hardware Battery Percentage for details.

About

This tab provides information about Stasis, developer details, community links, and several system management controls.

Updates

  • Automatically check for updates — Let Stasis periodically check for new versions and notify you.
  • Check frequency — Choose between Daily, Weekly, or Monthly checks.
  • When updates are found — Select "Notify only" or "Auto-download" to download updates seamlessly in the background.
  • Check for updates now — Manually check for an update immediately.

Privileged Helper

  • Install / Uninstall helper daemon — Manage the background daemon required for charging control directly from the UI. If you encounter permissions issues, you can uninstall and reinstall the helper here.

Reset Preferences

  • Reset all preferences — Restores all settings to their defaults, uninstalls the helper daemon, and disables launch at login.

Clone this wiki locally