Doorstopper Extension

Doorstopper is a Raycast extension which prevents your MacBook from going to sleep when you close the lid.

Note:
The underlying commands need to be run with sudo privileges.
The extension will prompt you for your password by default, or you can set up passwordless mode once.

Authenticate with Touch ID

Doorstopper can use Touch ID instead of a password when Touch ID authentication is enabled for sudo. This changes sudo authentication globally, not just within Raycast.

macOS Sonoma (14) and Later

1. Copy /etc/pam.d/sudo_local.template to /etc/pam.d/sudo_local:

   sudo cp /etc/pam.d/sudo_local.template /etc/pam.d/sudo_local
   

2. Uncomment the following line in /etc/pam.d/sudo_local:

   auth       sufficient     pam_tid.so
   

macOS Ventura (13) and Earlier

Add the following line to the auth entries in /etc/pam.d/sudo:

auth       sufficient     pam_tid.so

Changes to /etc/pam.d/sudo can be overwritten by macOS updates. If Touch ID is unavailable or not enabled for sudo, Doorstopper will continue to use the administrator password prompt.

Passwordless Mode and Auto-Off

Run Set up Passwordless Doorstopper to install a sudoers rule for your macOS account at /etc/sudoers.d/raycast-doorstopper-<username>. Each account on the Mac gets its own rule file. macOS asks for your admin password once. The rule lets your user run only these two commands as root without a password:

/usr/bin/pmset -a disablesleep 0
/usr/bin/pmset -a disablesleep 1

With the rule installed:

• Enabling and disabling Doorstopper no longer asks for a password or Touch ID.
• Timers become available, and the menu bar command disables Doorstopper when a timer ends, the battery drops to the Low Battery Cutoff, or the Mac restarts. Keep Doorstopper Status Menu Bar enabled for this.

Run the same command again to remove the rule.

Installation 🛠️

To install the Doorstopper extension, follow these steps:

1. Open Raycast.
2. Search for "Store" and navigate to the Raycast Store.
3. Search for "Doorstopper" and click "Install."

Usage 🚀

Once installed, simply trigger the Raycast command palette and search for the Doorstopper commands.

Features ✨

1. Enable Doorstopper

This command will enable Doorstopper, preventing your MacBook from sleeping when the lid is closed.

2. Disable Doorstopper

This command will disable Doorstopper, allowing your MacBook to sleep when the lid is closed.

3. Toggle Doorstopper

This command will toggle the Doorstopper status between enabled and disabled.

4. Doorstopper Status

This command will show the current status of Doorstopper (enabled or disabled).

5. Doorstopper Status Menu Bar

This command will show the current status of Doorstopper in the menu bar, with the time left on a timer. It checks every minute and disables Doorstopper when a timer ends, the battery is low, or the Mac restarted. From the menu you can enable Doorstopper for a preset, recent or custom duration.

6. Enable Doorstopper for Duration

Pick how long to keep the MacBook awake with the lid closed: 30 minutes, 1, 2 or 4 hours, or indefinitely. Type a duration such as 45m, 1h30, 2.5h or 1:30 (up to 7 days) to use your own. Timers need passwordless mode.

7. Set up Passwordless Doorstopper

Installs or removes the passwordless rule described above.

Preferences ⚙️

• Menu Bar Icon: the icon set for the menu bar, or None to hide it.
• Low Battery Cutoff: disable Doorstopper automatically on battery power at or below this level. Default 20%. Needs passwordless mode.
• Default Duration: how long Toggle Doorstopper enables it for. Default Indefinitely.