Start a session only when you need one
The active session is off by default and never automatically starts at launch. Enabling the feature only exposes its controls. Frog uses the system-wide pmset disablesleep setting rather than an ordinary idle-sleep assertion.
A Frog-owned session restores sleep at expiry, normal quit, or when an unplugged battery drops below 20%. Timer and battery checks run approximately once a minute. Choose a duration before enabling; the session page shows its deadline when applicable.
- Make Stay awake available in Features, then open its page.
- Complete Access setup if its status is Setup needed.
- In Session, choose 30 minutes, one hour, four hours, or until Frog quits. Four hours is the default.
- Turn on Keep this Mac awake. The menu-bar popup has the same control on one line: choose a duration, switch it on, and the popup shows when the session ends.
Show a cup in the menu bar
Under Menu bar on the Stay awake page, Show a cup in the menu bar adds an item of its own while Stay awake is on, in place of the small cup beside Frog’s icon. It is off by default and disappears when the session ends.
Choose Cup for the cup alone, Countdown ring for a ring that drains as a timed session runs out, or Time left for the cup with the remaining time, such as 2h 20m. A session until Frog quits keeps a full ring. Click the cup for Turn off Stay awake and Stay awake settings….
Complete the guided Terminal access setup
The guide manages the dedicated /etc/sudoers.d/frog-awake file and validates it with sudoers tooling. It verifies permission for both commands without changing the sleep setting during setup. Cached administrator authentication alone does not count as configured access.
Once authorized, Frog invokes the exact power commands with sudo -n, without a shell or a password prompt. Starting without permission leaves the switch off and offers setup. A successful guide closes its dedicated Terminal window; errors stay visible.
- Choose Set up access… under Stay awake → Access or in the menu popup.
- Read the bundled Terminal guide, which explains the two exact power commands and the account-specific sudoers rule.
- Enter your administrator password directly into Terminal’s sudo prompt when requested. Frog never receives or stores it.
- Finish validation. Frog checks the effective permissions again; Access shows Ready to use when both commands are allowed. Check access can refresh this status.
YOUR_SHORT_USERNAME ALL=(root) NOPASSWD: /usr/bin/pmset -a disablesleep 0, /usr/bin/pmset -a disablesleep 1Stop a session or reset access
Turn off Keep this Mac awake to end the session. Disabling Stay awake in Features first restores a Frog-owned session. If restoration fails, Frog reports the problem and retains the feature/session state so you can retry.
Stay awake → Access → Reset access… first restores sleep, then opens the Terminal guide. After your confirmation, the guide empties /etc/sudoers.d/frog-awake and validates sudoers. It leaves the empty dedicated file in place and does not edit the main sudoers file.
Reset shows Setup needed unless another system policy independently allows the same commands. Run setup again to restore access. If normal quit cannot restore sleep, Frog remains open and reports the error.
Session ownership and interrupted cleanup
Frog reads the actual power setting after changes. If another tool enabled it, the popup shows On outside Frog; Frog does not claim that session or switch it off just because Frog quits. You can explicitly turn it off.
A machine-local session marker lets the next launch restore sleep after an interrupted Frog-owned session. A crash or forced termination cannot perform normal quit cleanup, so the system setting may remain enabled until restart or manual restoration.
If needed, restore sleep from Terminal with the command below. Lock the Mac separately before closing its lid: sleep control does not lock the screen. Lid behavior still depends on the target Mac and should be checked there after setup.
sudo /usr/bin/pmset -a disablesleep 0