|0.5.0||Mar 8, 2023|
|0.4.3||Feb 26, 2023|
|0.3.1||Feb 7, 2023|
#303 in Command line utilities
27 downloads per month
caffeinate but it's written in Rust and has more options. Keeps your Mac wide awake.
In development. Works fine, but I want to add more features and document the different types of sleep before version 1.0.0.
Download the latest release from here.
This won't be available until version 1.0.0.
cargo install caffeinate2
Usage: caffeinate2 [OPTIONS] [COMMAND]... Arguments: [COMMAND]... Wait for given command to complete (takes priority above timeout and pid) Options: -v, --verbose Verbose mode --dry-run Dry run. Don't actually sleep. Useful for testing --drop-root Drop root privileges in command. Some programs don't want to work as root, but you need root to disable sleep entirely -d, --display Disable display sleep -m, --disk Disable disk idle sleep -i, --system Disable idle system sleep. Default if no other options are specified -s, --system-on-ac Disable system sleep while not on battery -e, --entirely Disable system sleep entirely (ignores lid closing) -u, --user-active Declare the user is active. If the display is off, this option turns it on and prevents it from going into idle sleep -t, --timeout <DURATION> Wait for X seconds. Also supports time units (like "1 day 2 hours 3mins 4s") -w, --waitfor <PID> Wait for program with PID X to complete -h, --help Print help -V, --version Print version
Sleep Timers (in order of priority)
Sleep disabled until the command completes. You should enclose the command in quotes, although sometimes it isn't required. Timeout and PID will be ignored if a command is specified.
caffeinate2 "sleep 5"
Timeout and PID
Sleep is disabled for a certain amount of time or until the program with the specified PID completes. If both are specified, it waits until one of them completes.
Timeout can either be a number of seconds or a duration string. For example, you can pass
-t 600 or
-t 10m to wait
for 10 minutes. You can create more descriptive durations, like
-t "1 hour and 30 minutes", but it only looks at the
first letter (so "3 movies" is just 3 minutes). Anything that's not a number followed by a letter will be ignored (the "
and" in the previous example). YOU MUST USE QUOTATION MARKS FOR THIS TO WORK. Otherwise, it will try to parse
anything that's past the space as a command, and ignore the timeout.
caffeinate2 -t 600
caffeinate2 -t "1 hour and 30 minutes"
caffeinate2 -w 1234
caffeinate2 -t 600 -w 1234
None of the above
Sleep will be disabled until you press
This project is licensed under the MIT License - see the license file for details.
- Make timeout and PID work together
- Figure out how to fake a tty (for example,
caffeinate2 brew listis uncolored)
- Print sleep types better
- Document all the sleep types (they are somewhat vague)
- Get system sleep status without reading a plist
- Get PID info by using Grand Central Dispatch instead of a weird
lsofhack - POSTPONED because it's a mess, and it currently Just Works™️