El comando caffeinate en Mac: todos los flags, con ejemplos

Cómo mantener la Mac despierta desde la Terminal con caffeinate: qué hacen -d, -i, -m, -s, -u, -t y -w, ejemplos para copiar y por qué igual se duerme.

Qué hace caffeinate

caffeinate es un comando que viene en toda Mac. Crea lo que macOS llama aserciones de energía: pedidos que le dicen al sistema «ahora no te duermas». Abrís la Terminal, lo escribís, y la Mac se queda despierta mientras el comando siga corriendo.

caffeinate

Sin flags evita la suspensión por inactividad, y lo sigue haciendo hasta que lo frenes: apretá Control-C en esa ventana de Terminal, o cerrala. No toca tus ajustes, así que después no hay nada que deshacer. Apenas caffeinate termina, la Mac vuelve a sus reglas de reposo de siempre.

Los flags, uno por uno

Cada flag elige qué tipo de reposo frenar. Se pueden combinar.

  • -d evita que se duerma la pantalla. Sirve para una presentación o para cualquier cosa que tengas que seguir mirando.
  • -i evita la suspensión por inactividad del sistema. La pantalla se puede apagar igual, pero las descargas, los renders y los scripts siguen. Es lo que hace si no le pasás ningún flag.
  • -m evita que se duerma el disco por inactividad.
  • -s evita la suspensión del sistema del todo, pero sólo mientras la Mac está enchufada. Con batería no hace nada, y eso sorprende a más de uno con una notebook.
  • -u declara que hay alguien usando la Mac: prende la pantalla si estaba apagada y evita que se duerma. Sin -t dura sólo 5 segundos, así que está pensado más para scripts que para el día a día.
  • -t pone un límite en segundos. Cuando se cumple, caffeinate suelta solo.
  • -w espera a que termine un proceso (por su PID) y después suelta.

Ejemplos para copiar

Mantener la Mac despierta una hora (3600 segundos) y después dejarla dormir normal:

caffeinate -i -t 3600

Con la pantalla prendida también, durante dos horas:

caffeinate -d -i -t 7200

Despierta mientras corre un comando. Ponés el comando después de caffeinate y la aserción dura exactamente lo que dure él. Acá es make, pero puede ser un script de backup, un rsync o una batería de tests larga:

caffeinate -i make

Despierta hasta que termine una app o un proceso que ya está corriendo. Buscá su PID (en el Monitor de Actividad, o con pgrep) y pasáselo a -w:

pgrep -x ffmpeg
caffeinate -i -w 48213

Dos detalles del manual: cuando corrés un comando después de caffeinate, -t no se usa y -w se ignora. El que decide cuánto dura es el comando.

Por qué tu Mac se durmió igual

Algunos casos en los que caffeinate está corriendo y la Mac se duerme igual, o lo parece:

  • Cerraste la tapa. Cerrar una MacBook la pone a dormir, y caffeinate no lo impide. La excepción es el modo tapa cerrada: con un monitor externo conectado, la Mac enchufada y teclado y mouse externos, macOS sigue andando con la tapa cerrada (Apple explica el armado acá). Es comportamiento de macOS, no algo que active caffeinate.
  • Usaste -s con batería. Sólo aplica enchufada.
  • Usaste -i y la pantalla se apagó. Es lo esperable: -i mantiene despierto el sistema, no la pantalla. Sumale -d.
  • Ya no está la ventana de Terminal. Cerrarla termina caffeinate.

Para ver qué está manteniendo despierta tu Mac ahora mismo (o qué no), preguntale al gestor de energía:

pmset -g assertions

Te muestra un resumen de todas las aserciones activas y qué proceso tiene cada una. Con caffeinate corriendo lo vas a ver en la lista, al lado de lo que sea que esté manteniendo la Mac arriba: una videollamada, una descarga, una app que se olvidó de soltar. También es la forma más rápida de averiguar por qué una Mac no se duerme.

Cuándo conviene un botón en la barra de menú

caffeinate es buenísimo dentro de scripts, y caffeinate -i make es difícil de superar cuando lo que esperás es un comando. Para el caso de todos los días (una descarga larga, un backup, una llamada, una presentación) lo que molesta es todo lo de alrededor: una ventana de Terminal que no podés cerrar, segundos que hay que calcular, y ninguna forma de ver de un vistazo si sigue prendido.

Por eso hicimos Keep Awake, un widget de Webstarted Toolbox, nuestra app gratis de menu bar. Para que quede claro: es nuestro. En la Mac no es otro mecanismo. Corre el mismo caffeinate, con los flags de esta página ya elegidos:

  • -i siempre, y -d para que la pantalla también quede prendida, salvo que le pidas que apague las pantallas cuando no estás.
  • -t según el plazo que elijas: atajos en minutos y en horas, una cantidad personalizada, o hasta apagar. Te muestra el tiempo que queda y se apaga solo al final.
  • -w apuntando al propio Toolbox, así que si la app se cierra o se cuelga, caffeinate termina con ella y tu Mac nunca se queda despierta sin querer.

También anda en Windows, donde no existe caffeinate, con la llamada de energía del propio sistema. Si vivís en la Terminal y lo necesitás sólo en scripts, seguí con caffeinate: ahí es la herramienta justa. Si lo único que querés es que la Mac aguante las próximas dos horas, un click es más cómodo que un comando.

Más herramientas de menu bar que funcionan así, en nuestra lista de apps gratis de menu bar. Si estás comparando apps de barra de menú para que la Mac no se duerma, las pusimos lado a lado en alternativas a Amphetamine, y si querés la pantalla apagada con la Mac trabajando, mirá cómo apagar la pantalla sin suspender.

Fuentes

Descargá Webstarted Toolbox

Keep Awake viene incluido en Toolbox: gratis, sin cuenta, macOS 12 en adelante (Intel y Apple silicon) y Windows 10 en adelante.

Beta gratis · macOS · Windows (x64) · Firmada y notarizada · Sin cuenta