docs » hs.redshift

A table holding the gamma values for given color temperatures; each key must be a color temperature number in K (useful values are between 1400 and 6500), and each value must be a list of 3 gamma numbers between 0 and 1 for red, green and blue respectively. The table must have at least two entries (a lower and upper bound); the actual gamma values used for a given color temperature are linearly interpolated between the two closest entries; linear interpolation isn't particularly precise for this use case, so you should provide as many values as possible.

Notes:

• hs.inspect(hs.redshift.COLORRAMP) from the console will show you how the table is built
• the default ramp has entries from 1000K to 10000K every 100K

Subscribes a callback to be notified when the color inversion status changes

You can use this to dynamically adjust the UI colors in your modules or configuration, if appropriate.

Parameters:

• id - (optional) a string identifying the requester (usually the module name); if omitted, fn itself will be the identifier; this identifier must be passed to hs.redshift.invertUnsubscribe()
• fn - a function that will be called whenever color inversion status changes; it must accept a single parameter, a string or false as per the return value of hs.redshift.isInverted()

Returns:

• None

Unsubscribes a previously subscribed color inversion change callback

Parameters:

• id - a string identifying the requester or the callback function itself, depending on how you called hs.redshift.invertSubscribe()

Returns:

• None

Checks if the colors are currently inverted

Parameters:

• None

Returns:

• false if the colors are not currently inverted; otherwise, a string indicating the reason, one of:
  • "user" for the user override (see hs.redshift.toggleInvert())
  • "redshift-night" if hs.redshift.start() was called with invertAtNight set to true, and it's currently night time
  • the ID string (usually the module name) provided to hs.redshift.requestInvert(), if another module requested color inversion

Sets or clears a request for color inversion

Parameters:

• id - a string identifying the requester (usually the module name)
• v - a boolean indicating whether to invert the colors (if true) or clear any previous requests (if false or nil)

Returns:

• None

Notes:

• you can use this function e.g. to automatically invert colors if the ambient light sensor reading drops below a certain threshold (hs.brightness.DDCauto() can optionally do exactly that)
• if the user's configuration doesn't explicitly start the redshift module, calling this will have no effect

Sets the schedule and (re)starts the module

Parameters:

• colorTemp - a number indicating the desired color temperature (Kelvin) during the night cycle; the recommended range is between 3600K and 1400K; lower values (minimum 1000K) result in a more pronounced adjustment
• nightStart - a string in the format "HH:MM" (24-hour clock) or number of seconds after midnight (see hs.timer.seconds()) indicating when the night cycle should start
• nightEnd - a string in the format "HH:MM" (24-hour clock) or number of seconds after midnight (see hs.timer.seconds()) indicating when the night cycle should end
• transition - (optional) a string or number of seconds (see hs.timer.seconds()) indicating the duration of the transition to the night color temperature and back; if omitted, defaults to 1 hour
• invertAtNight - (optional) a boolean indicating whether the colors should be inverted (in addition to the color temperature shift) during the night; if omitted, defaults to false
• windowfilterDisable - (optional) an hs.window.filter instance that will disable color adjustment (and color inversion) whenever any window is allowed; alternatively, you can just provide a list of application names (typically media apps and/or apps for color-sensitive work) and a windowfilter will be created for you that disables color adjustment whenever one of these apps is focused
• dayColorTemp - (optional) a number indicating the desired color temperature (in Kelvin) during the day cycle; you can use this to maintain some degree of "redshift" during the day as well, or, if desired, you can specify a value higher than 6500K (up to 10000K) for more bluish colors, although that's not recommended; if omitted, defaults to 6500K, which disables color adjustment and restores your screens' original color profiles

Returns:

• None

Stops the module and disables color adjustment and color inversion

Parameters:

• None

Returns:

• None

Sets or clears the user override for color temperature adjustment.

This function should be bound to a hotkey, e.g.: hs.hotkey.bind('ctrl-cmd','-','Redshift',hs.redshift.toggle)

Parameters:

• v - (optional) a boolean; if true, the override will enable color temperature adjustment on the given schedule; if false, the override will disable color temperature adjustment; if omitted or nil, it will toggle the override, i.e. clear it if it's currently enforced, or set it to the opposite of the current color temperature adjustment status otherwise.

Returns:

• None

Sets or clears the user override for color inversion.

This function should be bound to a hotkey, e.g.: hs.hotkey.bind('ctrl-cmd','=','Invert',hs.redshift.toggleInvert)

Parameters:

• v - (optional) a boolean; if true, the override will invert the colors no matter what; if false, the override will disable color inversion no matter what; if omitted or nil, it will toggle the override, i.e. clear it if it's currently enforced, or set it to the opposite of the current color inversion status otherwise.

Returns:

• None