Как изменить яркость экрана Mac через Terminal

Краткий обзор методов

• Быстрый метод: AppleScript-команды в Terminal эмулируют нажатие клавиш яркости (вверх/вниз) — удобно для поштучного изменения.
• Точный метод: утилита brightness (устанавливается через Homebrew) позволяет установить значение яркости от 0 до 1, например 0.5 = 50%.

Когда это полезно

• Автоматизация сценариев при запуске приложений.
• Удалённый доступ к Mac (через SSH) и необходимость сменить яркость без GUI.
• Настройка профиля энергосбережения в скриптах.

Как изменить яркость через Terminal — шаг за шагом

1) Откройте Terminal

Откройте встроенное приложение Terminal (Терминал) на Mac — через Spotlight, Launchpad или папку Программы → Утилиты.

2) Увеличение яркости на одну ступень

Выполните в Terminal команду, которая эмулирует нажатие клавиши «увеличить яркость»:

osascript -e'tell application "System Events"'-e'key code 144'-e' end tell'

После первой попытки macOS может потребовать разрешить Terminal управлять событиями системы. Это стандартная мера безопасности.

Разрешение для Terminal (если требуется)

Если команда не сработала автоматически, откройте:

Системные настройки → Безопасность и конфиденциальность → вкладка Конфиденциальность → Универсальный доступ. Найдите Terminal и отметьте его, чтобы разрешить управление.

После разрешения повторите команду — изменение яркости произойдёт сразу.

3) Уменьшение яркости на одну ступень

Аналогично, для уменьшения яркости используйте команду:

osascript -e'tell application "System Events"'-e'key code 145'-e' end tell'

Эти две команды удобны, когда нужно быстро пошагово менять яркость или встроить такие вызовы в скрипты.

Управление яркостью через Homebrew (точные значения)

Если вам нужно установить конкретную величину яркости (например 0.75 = 75%), установите утилиту brightness через Homebrew.

Установка (если Homebrew уже есть):

brew install brightness

Примеры использования:

Установить максимальную яркость:

brightness 1

Установить 50% яркости:

brightness 0.5

Утилита удобна для скриптов и автоматизации: можно передавать значение в диапазоне от 0 до 1.

Шпаргалка: команды и сценарии

• Увеличить яркость на один шаг (AppleScript):

osascript -e'tell application "System Events"'-e'key code 144'-e' end tell'

• Уменьшить яркость на один шаг (AppleScript):

osascript -e'tell application "System Events"'-e'key code 145'-e' end tell'

• Установить точную яркость (brightness):

brightness 0.8   # 80% яркости

• Установить значение через скрипт (пример bash):

#!/bin/bash
# Установить яркость 60%
brightness 0.6

Важно: разрешения и безопасность

• macOS просит права на управление событиями в целях безопасности. Даём доступ только проверенным приложениям.
• Для удалённого выполнения команд (через SSH) убедитесь, что ваша сессия имеет права на управление яркостью — иногда графические разрешения недоступны для сервисных сессий.

Альтернативы и когда методы не подходят

• Физические клавиши на клавиатуре — самый простой и безопасный способ для локального компьютера.
• Системные настройки → Дисплеи — удобны для визуальной настройки и автояркости.
• На некоторых внешних мониторах управление яркостью нужно делать через меню самого монитора — команды macOS не повлияют на такие экраны.

Устранение неполадок

• Команда AppleScript не работает: проверьте, есть ли Terminal в Универсальном доступе.
• brightness не найден: убедитесь, что Homebrew установлен и PATH корректен (обычно /usr/local/bin или /opt/homebrew/bin на Apple Silicon).
• После обновления macOS права доступа могли сброситься — проверьте настройки безопасности.

Критерии приёмки

• Команда AppleScript успешно меняет яркость на одну ступень вверх/вниз.
• Утилита brightness устанавливает конкретное значение в диапазоне 0–1 и эффект виден сразу.
• Все команды выполняются без ошибок после предоставления соответствующих прав.

Рекомендации по автоматизации

• Включайте проверку наличия утилиты brightness перед использованием в скриптах:

if command -v brightness >/dev/null 2>&1; then
  brightness 0.7
else
  echo "brightness не установлен"
fi

• Для профилей (ночь/день) создайте простые запускные скрипты и подключите через cron/launchd.

Короткая сводка

• AppleScript-команды подходят для поштучного управления яркостью и просты в использовании.
• Утилита brightness через Homebrew даёт точный контроль.
• Не забывайте давать Terminal доступ в Универсальный доступ и проверять PATH при использовании Homebrew.

FAQ

Q: Нужны ли права администратора для этих команд?

A: Обычно нет — нужны только права на управление событиями (Универсальный доступ). Установка Homebrew может потребовать прав, в зависимости от системы.

Q: Работает ли это на внешних мониторах?

A: Часто нет: внешние мониторы с аппаратным управлением яркости не всегда поддерживают изменение через macOS.

Q: Можно ли автоматизировать смену яркости по расписанию?

A: Да — используйте cron, launchd или скрипты с вызовом brightness/osascript.

Конец статьи. Подсказка: сохраняйте резервные копии скриптов и минимально требуемые права доступа для безопасности.