https://github.com/cyclenerd/macos-missing-shutdown-app
🍎 macOS Shutdown, Restart, Sleep and Log Out App
https://github.com/cyclenerd/macos-missing-shutdown-app
apple apple-automator applescript cli command-line mac macintosh macintosh-computer macos macosx restart shutdown spotlight
Last synced: 3 months ago
JSON representation
🍎 macOS Shutdown, Restart, Sleep and Log Out App
- Host: GitHub
- URL: https://github.com/cyclenerd/macos-missing-shutdown-app
- Owner: Cyclenerd
- License: apache-2.0
- Created: 2018-07-15T13:12:07.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2023-12-22T13:13:35.000Z (over 1 year ago)
- Last Synced: 2025-02-28T12:45:57.041Z (4 months ago)
- Topics: apple, apple-automator, applescript, cli, command-line, mac, macintosh, macintosh-computer, macos, macosx, restart, shutdown, spotlight
- Homepage:
- Size: 3.08 MB
- Stars: 6
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# System Control App for macOS
[](https://github.com/Cyclenerd/macos-missing-shutdown-app#readme)
[](https://github.com/Cyclenerd/macos-missing-shutdown-app#readme)
[](https://github.com/Cyclenerd/macos-missing-shutdown-app#readme)
**A simple, elegant macOS utility to control system power functions like shutdown, restart, sleep and log out with keyboard shortcuts.**
`Shutdown.app` is a lightweight utility that provides quick access to common system power functions.
With simple keyboard shortcuts and an intuitive interface, you can sleep, restart, shut down, or log out of your Mac with a single keystroke.
The app is designed to be minimal, fast, and keyboard-friendly.
It uses native macOS UI components for a seamless experience that integrates perfectly with your system.
## Features
* Sleep your Mac 😴 with ⌘ + Z
* Restart your Mac with ⌘ + R
* Shut Down your Mac with ⌘ + S
* Log Out of your account with ⌘ + L
* Clean, native macOS interface
* Full keyboard navigation support
* Color-coded buttons for easy identification
# Requirements
* macOS 14.6 (Sonoma) or later
* 1MB of free disk space
## Installation
1. [Download](https://github.com/Cyclenerd/macos-missing-shutdown-app/releases/latest/) the latest release
1. Extract the ZIP file and drag the app to your Applications folder
1. Launch the app from Launchpad or Applications folder
1. (Optional) Allow unsigned app on macOS
* Go to System Settings
* Click on Privacy & Security
* Scroll down to Security section
* Look for a message about the blocked `Shutdown.app` app and click "Open Anyway"
Tip: Use Spotlight Search and type `Shutdown` to sleep, restart, shut down, or log out of your Mac.
## Usage
1. Launch the app
1. Select an action using your mouse or keyboard (tab, ←, ↑, →, ↓)
1. Press Enter to confirm, or use the keyboard shortcuts:
* ⌘ + Z for Sleep 💤
* ⌘ + R for Restart
* ⌘ + S for Shut Down
* ⌘ + L for Log Out
* Escape to cancel
## Permissions
When first launched, the app may request accessibility permissions to control system functions.
These permissions are required for the app to function properly.
## Building from Source
**Prerequisites:**
* Xcode 16.2 or later
**Steps:**
Clone the repository:
```bash
git clone https://github.com/Cyclenerd/macos-missing-shutdown-app.git
```
Open the project in Xcode:
```bash
cd macos-missing-shutdown-app
open Shutdown.xcodeproj
```
Build the project:
Select `Product` > `Build` from the menu or use the keyboard shortcut ⌘ + B
Or build the project via CLI:
```bash
sudo xcode-select --switch "/Applications/Xcode.app"
xcodebuild -version
xcodebuild clean build -scheme "Shutdown" -destination "platform=macOS" CODE_SIGN_IDENTITY=""
xcodebuild archive -scheme "Shutdown" -destination "platform=macOS" -archivePath ./build/Shutdown.xcarchive CODE_SIGN_IDENTITY=""
```
## Code Structure
The app is built with SwiftUI and consists of two main files:
* `ShutdownApp.swift`: Contains the app entry point, system control logic, and models
* `ContentView.swift`: Contains the user interface implementation
## License
[Apache License Version 2.0](https://www.apache.org/licenses/LICENSE-2.0)