Skip to content

settings.md

Latest commit

 

History

History
63 lines (44 loc) · 3.08 KB

settings.md

File metadata and controls

63 lines (44 loc) · 3.08 KB
Raw

Settings

Open Settings from the panel's Options menu or press ⌘,. Every setting applies at once and survives relaunch.

General

Setting Control What it changes
Launch at Login switch Registers OpenUsage as a login item, so it starts when you sign in to your Mac.
Global Shortcut recorder A keyboard shortcut that opens and closes the panel from any app. Click the field and press the keys.

Appearance

Setting Control What it changes
Theme System, Light, Dark The panel's appearance. System follows macOS.
Time Format Auto, 12-hour, 24-hour How exact times read. Auto follows your macOS locale.

Usage display

Setting Control What it changes
Show Usage As Used, Left Whether every bounded reading says 48% used or 52% left, on the dashboard and in the menu bar. A click on any bar row's value in the dashboard flips it too.
Reset Times Countdown, Exact time Whether reset labels read Resets in 3h 25m or Resets today at 6:38 PM. A click on any reset in the dashboard flips it too.

Notifications

Three independent triggers, all off by default. Turning the first one on asks macOS for notification permission. While macOS has notifications off for OpenUsage, a footer under the switches says so and links to System Settings.

Setting What it sends
Under 10% Remaining The first time a metric with a limit drops under 10% left in its period.
Healthy Pace Changes When a metric's pace worsens from on course to close to the limit.
Near-Limit Pace Changes When a metric's pace worsens from close to the limit to running out.

Each notification names the trigger, the provider, and the metric, and fires once per metric per reset window.

Privacy

Setting Control What it changes
Help Make OpenUsage Better switch Whether the app sends the optional daily provider-refresh summaries described in Privacy. The anonymous daily active ping and crash reports do not depend on this switch.

Command Line

Setting Control What it changes
Terminal Helper Install…, Uninstall Links /usr/local/bin/openusage to the openusage command inside the app, after the macOS administrator prompt, or removes that link. A link left by another copy of OpenUsage (an earlier version, or a build in another folder) is replaced on Install. Reads Unavailable when something OpenUsage did not install already sits at that path. See Command line.

Updates

This section appears in the released build only; the dev build has no update feed.

Setting Control What it changes
Check Automatically switch Checks for a new version about once an hour and shows the Update Available banner on the dashboard when one is found.
Beta Updates switch Adds pre-release builds to the checks. Turn it off to stay on your current version until the next stable release.
Check for Updates… button Checks now and opens the update window.

See Updates.