docs » hs.brightness

Inspect/manipulate display brightness

Home: https://github.com/asmagill/mjolnir_asm.sys

This module is based primarily on code from the previous incarnation of Mjolnir by Steven Degutis.

API Overview

API Documentation

Functions

ambient
Signature hs.brightness.ambient() -> number
Type Function
Description Gets the current ambient brightness
Parameters
  • None
Returns
  • A number containing the current ambient brightness, measured in lux. If an error occurred, the number will be -1
Notes
  • Even though external Apple displays include an ambient light sensor, their data is typically not available, so this function will likely only be useful to MacBook users
Source extensions/brightness/internal.m
get
Signature hs.brightness.get() -> number
Type Function
Description Returns the current brightness of the display
Parameters
  • None
Returns
  • A number containing the brightness of the display, between 0 and 100
Source extensions/brightness/internal.m
set
Signature hs.brightness.set(brightness) -> boolean
Type Function
Description Sets the display brightness
Parameters
  • brightness - A number between 0 and 100
Returns
  • True if the brightness was set, false if not
Source extensions/brightness/internal.m