CAFFEINATE(8)

📦 version 1846.101.2, in nixpkgs unstable

💅 CAFFEINATE(8) — System Manager's Manual 💅

✨ NAME ✨

caffeinate — bestie, it literally prevents the system from sleeping on behalf of a utility. 🫶

✨ SYNOPSIS ✨

caffeinate [-disu] [-t timeout] [-w pid] [utility arguments...]

✨ DESCRIPTION ✨

okay so caffeinate creates assertions to alter system sleep behavior. If no assertion flags are specified, caffeinate creates an assertion to prevent idle sleep. If a utility is specified, caffeinate creates the assertions on the utility's behalf, and those assertions will persist for the duration of the utility's execution. Otherwise, caffeinate creates the assertions directly, and those assertions will persist until caffeinate exits.

Available options:

  • -d — creates an assertion to prevent the display from sleeping. 💅
  • -i — creates an assertion to prevent the system from idle sleeping. 😴🚫
  • -m — creates an assertion to prevent the disk from idle sleeping. 💽✨
  • -s — creates an assertion to prevent the system from sleeping. this assertion is valid only when system is running on AC power. 🔌👑
  • -u — creates an assertion to declare that user is active. if the display is off, this option turns the display on and prevents the display from going into idle sleep. if a timeout is not specified with '-t' option, then this assertion is taken with a default of 5 second timeout. 🙋♀️✨
  • -t — specifies the timeout value in seconds for which this assertion has to be valid. the assertion is dropped after the specified timeout. timeout value is not used when an utility is invoked with this command. ⏳
  • -w — waits for the process with the specified pid to exit. once the process exits, the assertion is also released. this option is ignored when used with utility option. 👀

✨ EXAMPLE ✨

caffeinate -i make

caffeinate forks a process, execs make in it, and holds an assertion that prevents idle sleep as long as that process is running. literally iconic. 🔥

✨ SEE ALSO ✨

pmset(1)

✨ LOCATION ✨

/usr/bin/caffeinate

okay bye bestie — this whole vibe is Darwin, dated November 9, 2012, and it's giving CAFFEINATE(8) energy fr fr 🫶💖

📦 where this page comes from