https://github.com/tykimos/steampack
Keep your Mac awake with a single click — macOS menu bar sleep toggle app
https://github.com/tykimos/steampack
macos macos-app menu-bar-app menubar pmset sleep swift utility
Last synced: 16 days ago
JSON representation
Keep your Mac awake with a single click — macOS menu bar sleep toggle app
- Host: GitHub
- URL: https://github.com/tykimos/steampack
- Owner: tykimos
- License: mit
- Created: 2026-04-11T08:25:21.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-11T08:54:44.000Z (3 months ago)
- Last Synced: 2026-04-11T10:26:01.912Z (3 months ago)
- Topics: macos, macos-app, menu-bar-app, menubar, pmset, sleep, swift, utility
- Language: Swift
- Size: 113 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](README_ko.md)
# SteamPack
**Keep your Mac awake with a single click.**
[](LICENSE)
[](https://www.apple.com/macos/)
[](https://swift.org)
[](scripts/build.sh)
*Toggle · Store · Forget — sleep control from the menu bar.*
[Getting Started](#-getting-started) · [How It Works](#-how-it-works) · [Usage](#-usage) · [Build](#-build-from-source) · [Architecture](#-architecture)
---
## What is this?
SteamPack is a **lightweight macOS menu bar utility** that toggles your Mac's sleep mode with a single click. It runs `pmset -a disablesleep` under the hood — no more typing long terminal commands.
> **Why "SteamPack"?** — Like a steam-powered jetpack that keeps you flying, SteamPack keeps your Mac running without ever touching down to sleep.
---
## ✨ Features
- **One-click toggle** — Enable or disable sleep from the menu bar
- **Scheduled sleep** — Keep Mac awake for 10m / 30m / 1h / 2h / 4h, then auto-sleep
- **Live countdown** — Remaining time displayed in the menu bar
- **Start at Login** — Optional auto-start when you log in
- **Secure password storage** — sudo password stored in macOS Keychain
- **Zero footprint** — No dock icon, no window, just a menu bar icon
- **Universal Binary** — Runs natively on Apple Silicon and Intel
- **No dependencies** — Pure AppKit, no third-party libraries
---
## 🚀 Getting Started
### Download DMG
1. Download `SteamPack.dmg` from [Releases](../../releases)
2. Open the DMG → drag **SteamPack** to **Applications**
3. Launch SteamPack
### Build from Source
```bash
git clone https://github.com/tykimos/steampack.git
cd steampack
bash scripts/build.sh
open build/SteamPack.app
```
> **Requires:** Xcode Command Line Tools (`xcode-select --install`)
---
## 👁 Usage
| Step | Action |
|------|--------|
| **Launch** | Eye icon appears in the menu bar |
| **First run** | Enter sudo password (stored in Keychain) |
| **Toggle** | Click icon → **Disable Sleep** / **Enable Sleep** |
| **Change password** | Click icon → **Change Password** |
| **Quit** | Click icon → **Quit** (`⌘Q`) |
### Menu Bar Icons
| Icon | State | Meaning |
|------|-------|---------|
| `eye.half.closed.fill` | Normal | Sleep **enabled** — Mac can sleep |
| `eye.fill` | Active | Sleep **disabled** — Mac stays awake |
| `hourglass.badge.eye` + countdown | Timer | Sleep disabled for set duration — countdown shown as `MM:SS` |
---
## ⚙️ How It Works
SteamPack executes `sudo pmset -a disablesleep 1` (disable) or `0` (enable) using the password stored in your macOS Keychain.
```mermaid
flowchart TB
subgraph MenuBar["macOS Menu Bar"]
ICON["👁 SteamPack Icon"]
end
subgraph Menu["Drop-down Menu"]
STATUS["Sleep Enabled / Disabled"]
TOGGLE["Disable Sleep ⌘T"]
CHANGEPW["Change Password"]
QUIT["Quit ⌘Q"]
end
subgraph Security["Security Layer"]
KEYCHAIN["🔑 macOS Keychain\n(sudo password)"]
end
subgraph System["macOS System"]
PMSET["sudo pmset -a disablesleep 1/0"]
end
ICON -->|Click| Menu
TOGGLE --> KEYCHAIN
KEYCHAIN -->|"stdin pipe"| PMSET
PMSET -->|"State changed"| STATUS
style MenuBar fill:#e8f4fd,stroke:#2196F3,color:#1565C0
style Menu fill:#fff3e0,stroke:#FF9800,color:#E65100
style Security fill:#e8f5e9,stroke:#4CAF50,color:#2E7D32
style System fill:#fce4ec,stroke:#E91E63,color:#880E4F
```
---
## 🏗 Architecture
```
steampack/
├── src/
│ ├── AppMain.swift # Entry point, NSStatusItem menu bar
│ ├── SleepToggle.swift # pmset execution & state detection
│ ├── KeychainHelper.swift # Keychain Services wrapper
│ └── PasswordPrompt.swift # Secure password input dialog
├── scripts/
│ ├── build.sh # Build automation (swiftc)
│ └── create-dmg.sh # DMG packaging (hdiutil)
├── AppInfo.plist # App bundle configuration
├── capture.jpg # Screenshot
├── README.md # English
└── README_ko.md # 한국어
```
---
## 🔒 Security
- Passwords stored exclusively in **macOS Keychain** (`com.steampack.sudo`)
- Password passed to sudo via **stdin pipe** — not visible in process list
- Authentication failure triggers password re-entry
- Ad-hoc code signed
---
## 📄 License
MIT License — see [LICENSE](LICENSE) for details.
*Built with ❤️ and [Claude Code](https://claude.ai/code)*