GitHub Repo
MIT
April 20, 2026 at 12:01 AM0 views
PanicLock: Instant Touch ID Disable and Screen Lock for macOS
@paniclockProject Author
- Overview
- PanicLock is a macOS menu bar utility designed to instantly disable Touch ID and lock the screen with a single click or by closing your laptop lid. It fills a gap in macOS security by providing immediate password-only protection in situations where biometrics could be coerced or observed. The tool is intentionally simple to use, yet powerful enough to interrupt biometric authentication rapidly when needed.
- The core value proposition is speed and reliability. A one-click panic lock, a flexible hotkey, or an automatic lock-on-lid-close option can dramatically reduce the opportunity for unauthorized access during sensitive moments. Importantly, PanicLock does not terminate your session or shut down your machine; it restores password-only protection without forcing you to log out, reboot, or lose work.
- The product embraces a privacy-first posture. It operates offline, does not collect telemetry or analytics, and stores only user preferences such as icon style and keyboard shortcuts. Its architecture relies on a privileged, carefully scoped helper to adjust Touch ID timeout settings and to trigger a lock, all while maintaining a minimal attack surface.
- Visual Identity

- The PanicLock branding centers on clarity and immediacy. The logo and accompanying name establish a recognizable symbol of security in the macOS ecosystem, reinforcing the notion of quick, decisive action when biometrics might be inappropriate or unsafe.
- The accompanying visual language (as reflected by the downloadable badge) communicates a straightforward user experience: a dependable, one-click solution that users can reach instantly from the macOS menu bar. The badge image serves as a clear call-to-action for obtaining the latest release, signaling trust and official distribution.
- Together, these visuals convey two fundamental ideas: simplicity in operation and confidence in security. The design choices are intentionally restrained, focusing attention on the action users want to perform in critical moments while avoiding distraction during everyday use.
- Key Features
- One-click panic lock
- A single interaction—either clicking the menu bar icon or pressing a designated hotkey—instantly locks the screen and disables Touch ID. This minimizes the window of opportunity for biometric bypass during a sensitive situation.
- Lock on Close
- When enabled in Preferences, closing the laptop lid triggers an automatic lock and disables Touch ID. This provides a seamless, hardware-triggered protection mechanism that works even when the user is stepping away briefly.
- Temporarily disables Touch ID
- PanicLock forces a password-only unlock, ensuring that subsequent unlock attempts require the password rather than a biometric credential.
- Auto-restore
- After the unlock, PanicLock automatically restores the original Touch ID settings, returning the system to its prior biometric state without manual intervention.
- Keyboard shortcut
- Users can configure a global hotkey (for example, ⌃⌥⌘L) to trigger the panic lock, enabling rapid response without navigating menus.
- Launch at login
- PanicLock can be configured to start automatically when you log in, ensuring that the protection is available as soon as you’re signed in.
- Privileged helper execution
- The application uses a privileged helper installed via SMJobBless to modify Touch ID timeout settings and trigger a lock, all under a controlled and auditable workflow.
- Installation
- Homebrew installation
- brew install paniclock/tap/paniclock
- This approach provides a straightforward, repeatable method for Mac users who manage packages via Homebrew. It integrates PanicLock into the system in a way that aligns with other development and productivity tools.
- Manual download
- Download the latest DMG from the releases page on GitHub. This method is ideal for users who prefer a manual approach or who want to review the build before installation.
- The binary distribution is designed to be easy to install and to minimize friction during setup.
- Requirements
- macOS 14.0 (Sonoma) or later
- Mac with Touch ID
- These requirements ensure that PanicLock can access and modify Touch ID settings while maintaining compatibility with modern macOS security primitives.
- Visual cue for download
- The download badge image reinforces the direct path to acquiring PanicLock, signaling a reliable, official source for the installer.
- Usage
- Left-click the PanicLock menu bar icon to trigger the panic lock immediately.
- This provides a rapid, tactile method to engage password-only protection without navigating through menus.
- Right-click the icon to access the in-app menu
- Preferences: adjust settings such as Lock on Close, auto-restore behavior, and shortcut configuration.
- Uninstall: remove PanicLock from the system in a guided manner.
- Quit: gracefully exit the application while preserving the configured state for future launches.
- The combination of a direct left-click action and a flexible right-click menu ensures both speed and configurability, accommodating power users and casual users alike.
- Lock on Close
- When this feature is enabled, closing your Mac’s lid automatically disables Touch ID and locks the screen.
- The lock is immediate and password-only; Touch ID remains unavailable until you re-login with your password.
- If the screen locks for other reasons (such as screensaver or display sleep), PanicLock does not interfere; Touch ID remains available in those ordinary scenarios.
- This behavior provides a robust safeguard for scenarios in which a user may momentarily leave the workspace or face potential coercion, ensuring that biometric unlock cannot resume without an explicit password entry.
- First Launch
- On initial use, PanicLock prompts for the administrator password to install the privileged helper.
- This is a one-time setup step that establishes the necessary privileged execution environment to modify Touch ID timeout settings and to trigger the lock.
- The prompt is designed to be straightforward and transparent, ensuring that users understand the security rationale and scope of the privileged operation.
- Building from Source
- Clone the repository to your development machine.
- Open PanicLock.xcodeproj in Xcode.
- Set your Development Team in both targets (PanicLock and PanicLockHelper).
- Update the Team ID in Info.plist (SMPrivilegedExecutables) and Info-Helper.plist (SMAuthorizedClients).
- Build and run to test locally.
- This process enables developers and advanced users to verify functionality, audit the code, and contribute improvements. The workflow emphasizes proper signing and team configuration to maintain security and distribution integrity.
- Uninstall
- Homebrew uninstall
- brew uninstall paniclock
- From the app
- Right-click → "Uninstall PanicLock…" → Enter admin password
- Manual uninstall
- sudo launchctl bootout system/com.paniclock.helper
- sudo rm -f /Library/PrivilegedHelperTools/com.paniclock.helper
- sudo rm -f /Library/LaunchDaemons/com.paniclock.helper.plist
- rm -rf /Applications/PanicLock.app
- The uninstallation steps are designed to be thorough yet straightforward, ensuring that both the application and the privileged helper are removed cleanly from the system when desired.
- How It Works
- PanicLock relies on a privileged helper installed via SMJobBless to modify the Touch ID timeout settings and to trigger the lock sequence.
- The workflow unfolds in four core steps: 1) Read current timeout via bioutil -r -s 2) Set timeout to 1 second via bioutil -w -s -o 1 3) Trigger the lock with pmset displaysleepnow 4) Restore the original timeout after approximately two seconds
- This sequence ensures that Touch ID is effectively disabled for the moment of lock, while preserving the user’s session and returning to the prior biometric configuration after unlock.
- The design emphasizes reliability, speed, and minimal disruption, focusing on returning to password-based security without forcing a session termination.
- Security and Privacy
- Minimal privileges
- The privileged helper runs only three hardcoded commands (bioutil and pmset), reducing the potential attack surface.
- Code-signed XPC
- The helper uses a signed XPC connection that verifies the connecting app’s bundle ID, team ID, and certificate to prevent spoofing or unauthorized control.
- No network activity
- PanicLock operates entirely offline; there is no telemetry, data transmission, or external communication during normal operation.
- No data collection
- The application stores only user preferences (icon style, keyboard shortcut) and does not collect usage data or personal information.
- Open source
- The full codebase is available for audit, enabling independent verification of security claims and behavior.
- Important caveat
- PanicLock only disables Touch ID. If other unlock methods (e.g., Apple Watch, security keys) are enabled, your Mac can still be unlocked using those methods. PanicLock does not disable all forms of authentication, but it does remove the biometric unlock in the specified context of the lock action.
- Releasing and Distribution
- The release script orchestrates building, signing, notarizing, and packaging:
- ./scripts/release.sh
- Features of the release workflow:
- Automatically extracts the version from the Xcode project
- Signs with a Developer ID suitable for distribution outside the App Store
- Submits the build for Apple notarization (the process can take minutes to hours)
- Creates a notarized DMG for distribution
- Supports parallel notarizations, with each version placed in its own build/release/
directory - Release workflow steps:
1) Bump MARKETING_VERSION in Xcode
2) Run the release script to build and submit for notarization
3) Check the status later and continue when approved
4) Final output: build/release/
/PanicLock- .dmg - This approach aligns with Apple’s distribution and security requirements while ensuring that users receive a trusted, notarized product.
- Licensing
- PanicLock is released under the MIT License.
- The LICENSE file in the repository contains full terms and conditions.
- The MIT license emphasizes permissive use, modification, distribution, and private use, while also acknowledging the need for attribution and a disclaimer of warranty.
- Open source licensing makes it feasible for researchers, developers, and security-conscious users to review, verify, and contribute to the project.
- Contributing
- Contributions are welcome!
- The project encourages open issues and pull requests to propose enhancements, report bugs, or review security considerations.
- For contributors, the repository typically provides guidelines on coding standards, testing procedures, and how to submit changes for review.
- Engaging with the project helps improve the security model, expands compatibility with newer macOS releases, and ensures that the tool remains responsive to user needs and security threats.
- Notes and Limitations
- PanicLock disables only Touch ID; other unlock methods may still be usable if they are configured on the system.
- The feature set and behavior are designed to be predictable and auditable, with a strong emphasis on user control (e.g., preferences for Lock on Close and hotkey configuration).
- Users should be aware that the privileged helper operates with elevated permissions to modify biometric timeout settings and trigger a lock; this is managed through a signed, well-scoped workflow to minimize risk.
- While designed for security, PanicLock is not a substitute for comprehensive physical security practices or for securing a workstation in shared environments.
- Regular updates and careful handling of admin privileges are recommended to maintain compatibility with macOS updates (especially changes to how biometrics and system lockdown behave in future releases).
- Summary
- PanicLock delivers a focused, high-assurance response to the need for immediate password-only protection on macOS, bridging a gap left by the default biometric system.
- Through a combination of a simple one-click action, configurable hotkeys, and an automatic Lock on Close feature, users can respond decisively in sensitive moments without interrupting their work more than necessary.
- The solution emphasizes security, privacy, and transparency: a minimal privilege model, code-signed XPC, full open-source availability, offline operation, and no data collection.
- The installation pathways—Homebrew and manual download—cater to different user preferences, while the build-from-source and release scripts support developers and maintainers in ensuring ongoing quality and compliance with Apple’s notarization requirements.
- By combining thoughtful UX with principled security design, PanicLock aims to become a dependable tool for Mac users who value both convenience and robust protection in emotionally or physically risky situations.
- Images from the input are included to reinforce brand identity and to illustrate the download path, enhancing the user’s understanding of the product and its official distribution channel. The PanicLock logo and the Download PanicLock badge visually anchor the description to the source material and provide immediate recognition for prospective users.
Enjoying this project?
Discover more amazing open-source projects on TechLogHub. We curate the best developer tools and projects.
Repository:https://github.com/paniclock/paniclock
GitHub - paniclock/paniclock: PanicLock: Instant Touch ID Disable and Screen Lock for macOS
PanicLock is a macOS menu bar utility that instantly disables Touch ID and locks the screen with a single click or by closing your laptop lid, providing immedia...
github - paniclock/paniclock
Project
paniclock-instant-touch-id-disable-and-screen-lock-for-macos
Created
April 20
Last Updated
April 20, 2026 at 12:01 AM