# Install zzz with Homebrew, apk, Nix

Command-line tool to put Macs to sleep. Version 1 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:zzz
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install zzz
```

  Evidence: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add zzz
```

  Evidence: Alpine Linux edge package indexes: zzz from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Nix (92%):

```sh
nix profile install nixpkgs#zzz
```

  Evidence: nixpkgs package indexes: pkgs/by-name/zz/zzz/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:zzz
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/zzz>
- **Version:** 1
- **Source summary:** Command-line tool to put Macs to sleep
- **Homepage:** <https://github.com/Orc/Zzz>
- **Repository:** <https://github.com/Orc/Zzz>
- **Upstream docs:** <https://github.com/Orc/Zzz#readme>
- **License:** LicenseRef-Homebrew-public-domain
- **Source archive:** <https://github.com/Orc/Zzz/archive/refs/tags/v1.tar.gz>
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- Zzz (cli)
- Zzz (alias)

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_big_sur, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, big_sur, catalina, monterey, sonoma, ventura

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1
- Local data: ok
- Upstream repository: https://github.com/Orc/Zzz
- info: No package-manager update timestamp was available.
- info: No cached GitHub release or tag data was available.
## Project history and usage

Zzz is a tiny macOS command-line utility that immediately requests system sleep. It is essentially a packaged one-command wrapper around Apple's IOKit power-management APIs.

### Project history

The upstream README presents Zzz as a command-line macOS sleep program similar to SleepNow, with traditional make-based installation and a Homebrew installation path. The source is intentionally small C code using IOMasterPort, IOPMFindPowerManagement, and IOPMSleepSystem to ask macOS to sleep.

There is little public narrative around the project beyond the README and source, so its history is best understood as preservation of a tiny utility rather than an evolving application ecosystem.

### Adoption history

Adoption appears narrow: users install it when they want a memorable terminal command that sleeps a Mac immediately, especially in scripts or shell workflows where a GUI sleep command is awkward. The README's explicit Homebrew instructions show that package-manager installation is part of the intended usage story.

### How it is used

Usage is intentionally minimal: run Zzz, and the Mac sleeps immediately. The program has no configuration file, credentials, long-running daemon, or visible help flow; its behavior is the side effect of calling the macOS power-management sleep API.

### Why package nerds care

Zzz is package-nerd significant as an extreme small-package case. It demonstrates why package indexes contain tiny platform appliances: a few lines of C plus a stable command name can be more convenient than remembering or retyping lower-level system calls or scripts.

It also shows the maintenance quirks of old macOS C utilities: even a sleep wrapper depends on SDK headers, IOKit linkage, and small compatibility fixes over time.

### Timeline

- Public README era: Zzz is documented as a command-line macOS sleep program with make-based installation and Homebrew installation instructions.
- Current source: Zzz implements sleep by opening the macOS power-management connection and calling IOPMSleepSystem.

### Related projects

- Related tools and APIs include Apple's IOKit power-management APIs, pmset sleepnow, SleepNow-style utilities, SleepWatcher, caffeinate as the opposite keep-awake workflow, and other macOS command-line power-management helpers.

### Sources

- <https://github.com/Orc/Zzz>
- <https://raw.githubusercontent.com/Orc/Zzz/master/README.md>
- <https://raw.githubusercontent.com/Orc/Zzz/master/Zzz.c>
- <https://support.apple.com/guide/mac-help/schedule-your-mac-to-turn-on-or-off-mchl40376151/mac>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** zzz
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Requirements:** macos
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Nix - zzz: normalized package name match | nixpkgs package indexes: pkgs/by-name/zz/zzz/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - zzz - 0.2.0-r0: normalized package name match | Alpine Linux edge package indexes: zzz from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Suspend or hibernate your computer | https://github.com/jirutka/zzz
- apk - zzz-doc - 0.2.0-r0: normalized package name match | Alpine Linux edge package indexes: zzz-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Suspend or hibernate your computer (documentation) | https://github.com/jirutka/zzz


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider.
- [powerman](https://www.automicvault.com/pkg/brew/powerman/) - Shares av.db curated category or tags: cli, power-management, system.
- [nut](https://www.automicvault.com/pkg/brew/nut/) - Shares av.db curated category or tags: cli, power-management, system.
- [sleepwatcher](https://www.automicvault.com/pkg/brew/sleepwatcher/) - Shares av.db curated category or tags: cli, macos, sleep, system.
- [apcupsd](https://www.automicvault.com/pkg/brew/apcupsd/) - Shares av.db curated category or tags: cli, power-management, system.
- [asitop](https://www.automicvault.com/pkg/brew/asitop/) - Shares av.db curated category or tags: cli, macos, system.
- [bluetoothconnector](https://www.automicvault.com/pkg/brew/bluetoothconnector/) - Shares av.db curated category or tags: cli, macos, system.
- [blueutil](https://www.automicvault.com/pkg/brew/blueutil/) - Shares av.db curated category or tags: cli, macos, system.
- [brightness](https://www.automicvault.com/pkg/brew/brightness/) - Shares av.db curated category or tags: cli, macos, system.
- [mas](https://www.automicvault.com/pkg/brew/mas/) - Local package facts share a topical domain. Shared terms: cli, command-line, line, macos, management.
- [mist-cli](https://www.automicvault.com/pkg/brew/mist-cli/) - Local package facts share a topical domain. Shared terms: cli, command-line, line, macos, management.

## Combined YAML source

View the package source record on GitHub. [combined/zzz.yml](https://github.com/automic-vault/db/blob/main/combined/zzz.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
