SteamPack

Keep your Mac awake with a single click.

Toggle · Store · Forget — sleep control from the menu bar.

Getting Started · How It Works · Usage · Build · 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
2. Open the DMG → drag SteamPack to Applications
3. Launch SteamPack

Build from Source

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.

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

Loading

---

🏗 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 for details.

Built with ❤️ and Claude Code