Skip to content

README.md

Latest commit

 

History

History
73 lines (52 loc) · 2.26 KB

README.md

File metadata and controls

73 lines (52 loc) · 2.26 KB

Off

Off is a tiny macOS menu bar utility that tells you exactly ten things and then gets out of the way.

  • last full shutdown
  • last start
  • running for
  • thermal state
  • power source
  • time remaining
  • sleeps this run
  • battery cycles
  • battery health
  • macOS version

No window. No Dock icon. No settings. No login item. No polling. Off wakes up only when you click it.

Download

Download Off.dmg

Drag Off.app into Applications and launch it.

Current releases are unsigned and not notarized. On first launch, macOS may block the app. If that happens:

  1. Control-click Off.app.
  2. Choose Open.
  3. Confirm the launch.

You can also allow it from System Settings > Privacy & Security.

What Each Row Means

  • last full shutdown: the most recent full shutdown event, not sleep and not restart.
  • last start: when the current macOS run began.
  • running for: how long the current run has been active.
  • thermal state: system thermal pressure — normal, fair, high, or critical.
  • power source: on battery, charging, plugged in, or desktop mac.
  • time remaining: estimated time left on battery, or time until fully charged. — when plugged in or on a desktop.
  • sleeps this run: how many sleep events happened since the current run began.
  • battery cycles: the battery cycle count reported by the system.
  • battery health: current maximum battery capacity as a percentage of design capacity.
  • macOS version: the running macOS version number.

If the Mac has no battery, Off shows desktop mac, battery cycles becomes —, battery health becomes —, and time remaining becomes —.

Build Locally

xcodebuild -project Off/Off.xcodeproj -scheme Off -configuration Debug CODE_SIGNING_ALLOWED=NO build
xcodebuild -project Off/Off.xcodeproj -scheme Off -configuration Release CODE_SIGNING_ALLOWED=NO build

Build A DMG

./scripts/build-dmg.sh

That produces:

dist/Off.dmg

Ship A Release

  1. Commit your changes.
  2. Create a version tag like v1.0.0.
  3. Push the branch and tag to GitHub.
  4. GitHub Actions builds Off.dmg and attaches it to the release.

The release workflow lives in .github/workflows/release.yml.