https://github.com/ltguillaume/redshift-tray

A no-frills GUI for the excellent Redshift, with some optional OS hotkeys
https://github.com/ltguillaume/redshift-tray

autohotkey autohotkey-script color-temperature hotkeys redshift screen-brightness windows wrapper

Last synced: 5 months ago
JSON representation

A no-frills GUI for the excellent Redshift, with some optional OS hotkeys

• Host: GitHub
• URL: https://github.com/ltguillaume/redshift-tray
• Owner: ltguillaume
• License: gpl-3.0
• Created: 2017-03-03T06:57:30.000Z (over 8 years ago)
• Default Branch: main
• Last Pushed: 2024-09-11T13:31:00.000Z (about 1 year ago)
• Last Synced: 2025-03-31T21:34:50.059Z (6 months ago)
• Topics: autohotkey, autohotkey-script, color-temperature, hotkeys, redshift, screen-brightness, windows, wrapper
• Language: AutoHotkey
• Homepage: https://codeberg.org/ltguillaume/redshift-tray
• Size: 1.18 MB
• Stars: 61
• Watchers: 6
• Forks: 1
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          


# Redshift Tray

by ltGuillaume: [Codeberg](https://codeberg.org/ltGuillaume) | [GitHub](https://github.com/ltGuillaume) | [Buy me a beer](https://buymeacoff.ee/ltGuillaume) 🍺

## Overview

Redshift Tray is a no-frills GUI for the excellent screen temperature adjustment tool [Redshift](https://github.com/jonls/redshift) by Jon Lund Steffensen. Redshift Tray allows you to:

- Control Redshift based on location or custom night/day times

- Quickly enable/disable Redshift: double-click the tray icon

- Force a full nighttime temperature adjustment, no matter what the actual time is

- Pause the temperature adjustment for x minutes

- Adjust the screen brightness and forced temperature via hotkeys

- Optionally update your current coordinates every time you enable Redshift (e.g. when traveling)

- Use a fantastic set of extra hotkeys that have got nothing to do with Redshift

- Make use of Remote Desktop: Redshift hotkeys will stay active locally, while Redshift Tray can also run on the remote system for its optional hotkeys

It also includes a set of extra hotkeys. Admittedly, these are entirely based on my personal preferences, but since this program is put together in [AutoHotkey](http://www.autohotkey.com), it's easy to add your own hotkeys and remove the ones you think are rubbish.

## List of hotkeys

__Hotkeys__ |  

:---: |---

Alt Home | Reset Redshift (press again to reset brightness)

Alt Pause | Pause Redshift for the set amount of minutes

Alt End | Disable Redshift

Alt PgUp | Increase brightness

Alt PgDn | Decrease brightness

RAlt Home | Force night temperature (press again to reset brightness)

RAlt End | End forced temperature

RAlt PgUp | Increase forced temperature

RAlt PgDn | Decrease forced temperature

__Extra Hotkeys__ |  

LCtrl LWin | Type to run

RWin | 

RCtrl RAlt | 

RCtrl Menu | 

LCtrl LWin x2 | Windows Run dialog

RWin x2 | 

RCtrl RAlt x2 | 

RCtrl Menu x2 | 

RAlt 9 | Toggle window on top click-through

RAlt 0 | Toggle window always on top

RAlt - | Decrease window opacity

RAlt = | Increase window opacity

RAlt . | Switch between open items (Alt Tab)

RAlt , | Switch between open items (Shift Alt Tab)

RAlt x2 | Close current tab/window

Menu + Arrows | Aero Snap

Menu Pause | Suspend computer

Menu Home | Restart computer

Menu End | Hibernate computer

Menu P | Presentation display mode

Menu , | MM: Previous

Menu . | MM: Next

Menu / | MM: Stop

Menu Shift | MM: Play/Pause

Menu M | MM: Mute

RCtrl Up | MM: Volume up

RCtrl Down | MM: Volume down

Wheel on taskbar | MM: Volume up/down

Double-click on taskbar | Show desktop

Middle-click on taskbar | Open Task Manager

Ctrl click on taskbar | Toggle autohide taskbar

__Remote Desktop mode__ |  

RCtrl x2 | Switch between RDP host/client

## Getting started

1. Download Redshift Tray from the [releases page](https://github.com/ltGuillaume/Redshift-Tray/releases) and extract it to a folder for which your user account has writing permissions. Alternatively, you can install it [with Chocolatey](https://chocolatey.org/packages/rstray) or [with Scoop](https://scoop.sh) (`scoop bucket add extras`, then `scoop add redshift-tray`).

2. Run __rstray.exe__ and you'll see a handsome icon pop up in the notification area next to your clock. Now right-click it and choose __Settings__. You can quickly switch some features on/off, or choose __More Settings__. The text file __rstray.ini__ that shows up in your editor contains all the settings for Redshift Tray.

    - For accurate coordinates, you can set them yourself, otherwise it uses your IP and the [ipapi](https://ipapi.co) service (__one time only__). Use a search engine, Maps, Wikipedia, or whatever and jot down your coordinates behind __latitude__ and __longitude__. Use periods (__.__) for decimal symbols.

    - During the day, the color temperature should match the light from outside, typically around 5500K-6500K. The light has a higher temperature on an overcast day. Redshift assumes that your screen will produce light at a color of 6500K when no color correction is applied by the program. Thus, 6500K is the neutral temperature. The __daytemp__ setting helps you set this value (e.g. `daytemp=6500`).

    - At night, the color temperature should be set to match the lamps in your room. This is typically a low temperature at around 3000K-4000K. The __nighttemp__ setting helps you out here (e.g. `nighttemp=3500`).

    - Redshift Tray can check if the active window is in full-screen mode and automatically switch to a different color temperature (useful for image viewers and video players). Set the __fullscreentemp__ to your preferred value and enable this feature with `fullscreenmode=1`.  If you wish to exclude some full-screen windows from full-screen mode (such as browsers), you can specify a list of their [WinTitles](https://www.autohotkey.com/docs/misc/WinTitle.htm) in __fullscreenignore__. For example, `fullscreenignore=ahk_class MozillaWindowClass|ahk_class Chrome_WidgetWin_1` will exclude Firefox and Chrome/Chromium windows from full-screen mode.

    - You can temporarily disable Redshift's color adjustment for a few (or a whole lotta) minutes. Set the amount of those hella blue minutes with the __pauseminutes__ setting.

    - If you want total control over the times at which Redshift will be setting the color temperature, adjust `nighttime=1800` and `daytime=0600`, where the values depict 24h military time. Then, set `customtimes=1`. At night, the `nighttemp` value will be applied, while during the day, the `daytemp` will be set.

    - In some cases (especially when switching to and from external screens), Redshift might crash. If the mode is Enabled, Redshift Tray can periodically check whether the process _redshift.exe_ should be restarted. For example, you can define `keepaliveseconds=5` to check for the Redshift process every 5 seconds. A value of 0 will turn it off.

    - If you get annoyed by the fact that your mouse cursor does not assume the same color temperature, set `colorizecursor=1` and Redshift Tray will write _MouseTrails=-1_ to _HKCU\Control Panel\Mouse_ in your registry to fix this. You'll need to save and exit the config file, then __restart Windows or log off__ to get this working.

    - The setting `hotkeys=1` will enable the set of hotkeys, while (big surprise) `hotkeys=0` disables them. Similarly, you can control the extra set of hotkeys with the entry __extrahotkeys__.

    - Among these hotkeys is RAlt x2, for which you can specify a set of [WinTitles](https://www.autohotkey.com/docs/misc/WinTitle.htm) to use Ctrl+W instead of Alt+F4. For example, specify `ctrlwforralt=ahk_class TTOTAL_CMD|ahk_exe gajim.exe` to use Ctrl+W for the Total Commander main window (which has tabs) and Gajim messenger windows.

    - With `keepbrightness=1` you can apply the brightness setting even when you disable the gamma adjustment (when paused or disabled). This could help if your monitor starts humming or flickering with a low backlight brightness. You will lose some "color space", though.

    - If you have loaded an ICC profile or have done a custom display calibration (Control Panel > Color Management > Advanced), Redshift might interfere with this. As such, you can set `keepcalibration=1` to have Redshift Tray keep that into account. This will, however, require Redshift Tray to run as administrator (it will take care of that for you).

    - If you loathe the fading transition upon start-up, just set `nofading=1`.

    - If you're a Remote Desktop addict like me, be sure to set `remotedesktop=1`. This way, you can run this gem in both environments, switch between local and remote sessions by double-tapping RCtrl, and change the local Redshift settings while in a remote screen.

    - I often continue a session remotely via a laptop without numeric keypad. Once I return to the system and log on locally, I want the NumLock state to be enabled again. `rdpnumlock=1` will take care of this.

    - If you want to be able to use the hotkeys when a program that runs as administrator is focused, set `runasadmin=1` so that Redshift Tray will try to run as administrator, too.

    - If you don't want Redshift to be enabled on start-up (because you just want to use the fancy hotkeys, for example), set `startdisabled=1`.

    - Traveling with your laptop? You can set `traveling=1` after which the coordinates will be updated every time Redshift is enabled. It'll keep its mouth shut if there's no Internet connection, though. Be aware that each time this will trigger a query to the [ipapi](https://ipapi.co) service (specifically to the URL `https://ipapi.co/latlong`). Since the location is based on your IP, don't use this when a VPN is active.

3. Now save the settings file and close it. Redshift Tray will restart with the settings you've defined.

4. If you'd like Redshift Tray to automatically run at startup, right-click the tray icon again and click __Autorun__ under __Settings__, so that this option is checked. This setting creates a scheduled task so that Redshift Tray will start when the current user is logging on. It will try to run as administrator if you have enabled _keepcalibration_ or _runasadmin_.

5. If Redshift [fails to adjust the color temperature](http://jonls.dk/2010/09/windows-gamma-adjustments), or the brightness level gets stuck at a certain percentage, import __unlock-gammarange.reg__ into the registry and restart Windows.

You. Are. Done!

## Credits

* [Redshift](https://github.com/jonls/redshift) by [Jon Lund Steffensen](https://github.com/jonls)

* Icon created from a damn good [design](http://www.laytondiament.com/blog/2015/5/3/design-chill-sunset-icon) by [Layton Diament](http://www.laytondiament.com)  

* [AutoHotkey](https://www.autohotkey.com), a scripting language for desktop automation by Chris Mallet and others.  

* [Redshift](https://github.com/jonls/redshift) by [Jon Lund Steffensen](https://github.com/jonls)

* [ipapi](https://ipapi.co) by Kloudend, Inc. ([Privacy Policy](https://ipapi.co/privacy))

* [Chocolatey package](https://chocolatey.org/packages/rstray) by [tunisiano187](https://github.com/tunisiano187)

* [Scoop package](https://github.com/lukesampson/scoop-extras/blob/master/bucket/redshift-tray.json) by [Ash258](https://github.com/Ash258), [r15ch13](https://github.com/r15ch13) and [linsui](https://github.com/linsui)