{"id":16565276,"url":"https://github.com/ltguillaume/redshift-tray","last_synced_at":"2025-10-19T02:56:37.853Z","repository":{"id":45683013,"uuid":"83767840","full_name":"ltguillaume/redshift-tray","owner":"ltguillaume","description":"A no-frills GUI for the excellent Redshift, with some optional OS hotkeys","archived":false,"fork":false,"pushed_at":"2024-09-11T13:31:00.000Z","size":1242,"stargazers_count":61,"open_issues_count":4,"forks_count":1,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-03-31T21:34:50.059Z","etag":null,"topics":["autohotkey","autohotkey-script","color-temperature","hotkeys","redshift","screen-brightness","windows","wrapper"],"latest_commit_sha":null,"homepage":"https://codeberg.org/ltguillaume/redshift-tray","language":"AutoHotkey","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ltguillaume.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":["buymeacoff.ee/ltGuillaume"]}},"created_at":"2017-03-03T06:57:30.000Z","updated_at":"2025-03-31T09:32:10.000Z","dependencies_parsed_at":"2024-10-11T20:56:52.244Z","dependency_job_id":null,"html_url":"https://github.com/ltguillaume/redshift-tray","commit_stats":null,"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ltguillaume%2Fredshift-tray","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ltguillaume%2Fredshift-tray/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ltguillaume%2Fredshift-tray/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ltguillaume%2Fredshift-tray/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ltguillaume","download_url":"https://codeload.github.com/ltguillaume/redshift-tray/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253181418,"owners_count":21866991,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["autohotkey","autohotkey-script","color-temperature","hotkeys","redshift","screen-brightness","windows","wrapper"],"created_at":"2024-10-11T20:46:40.506Z","updated_at":"2025-10-19T02:56:37.844Z","avatar_url":"https://github.com/ltguillaume.png","language":"AutoHotkey","funding_links":["buymeacoff.ee/ltGuillaume"],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"Icons/redshift.ico\" align=\"right\"\u003e\r\n\r\n# Redshift Tray\r\nby ltGuillaume: [Codeberg](https://codeberg.org/ltguillaume) | [GitHub](https://github.com/ltguillaume) | [Buy me a beer](https://coff.ee/ltguillaume) 🍺\r\n\r\n## Overview\r\nRedshift 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:\r\n\r\n- Control Redshift based on location or custom night/day times\r\n- Quickly enable/disable Redshift: double-click the tray icon\r\n- Force a full nighttime temperature adjustment, no matter what the actual time is\r\n- Pause the temperature adjustment for x minutes\r\n- Adjust the screen brightness and forced temperature via hotkeys\r\n- Optionally update your current coordinates every time you enable Redshift (e.g. when traveling)\r\n- Use a fantastic set of extra hotkeys that have got nothing to do with Redshift\r\n- 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\r\n\r\nIt 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.\r\n\r\n## List of hotkeys\r\n\r\n__Hotkeys__ | \u0026nbsp;\r\n:---: |---\r\nAlt Home | Reset Redshift (press again to reset brightness)\r\nAlt Pause | Pause Redshift for the set amount of minutes\r\nAlt End | Disable Redshift\r\nAlt PgUp | Increase brightness\r\nAlt PgDn | Decrease brightness\r\nRAlt Home | Force night temperature (press again to reset brightness)\r\nRAlt End | End forced temperature\r\nRAlt PgUp | Increase forced temperature\r\nRAlt PgDn | Decrease forced temperature\r\n__Extra Hotkeys__ | \u0026nbsp;\r\nLCtrl LWin | Type to run\r\nRWin | \r\nRCtrl RAlt | \r\nRCtrl Menu | \r\nLCtrl LWin x2 | Windows Run dialog\r\nRWin x2 | \r\nRCtrl RAlt x2 | \r\nRCtrl Menu x2 | \r\nRAlt 9 | Toggle window on top click-through\r\nRAlt 0 | Toggle window always on top\r\nRAlt - | Decrease window opacity\r\nRAlt = | Increase window opacity\r\nRAlt . | Switch between open items (Alt Tab)\r\nRAlt , | Switch between open items (Shift Alt Tab)\r\nRAlt x2 | Close current tab/window\r\nMenu + Arrows | Aero Snap\r\nMenu Pause | Suspend computer\r\nMenu Home | Restart computer\r\nMenu End | Hibernate computer\r\nMenu P | Presentation display mode\r\nMenu , | MM: Previous\r\nMenu . | MM: Next\r\nMenu / | MM: Stop\r\nMenu Shift | MM: Play/Pause\r\nMenu M | MM: Mute\r\nRCtrl Up | MM: Volume up\r\nRCtrl Down | MM: Volume down\r\nWheel on taskbar | MM: Volume up/down\r\nMiddle-click on taskbar | MM: Mute\r\nDouble-click on taskbar | Open Task Manager\r\nAlt + click on taskbar | Show desktop\r\nCtrl + click on taskbar | Toggle autohide taskbar\r\n__Remote Desktop mode__ | \u0026nbsp;\r\nRCtrl x2 | Switch between RDP host/client\r\n\r\n## Getting started\r\n1. Download Redshift Tray from the [releases page](https://codeberg.org/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`).\r\n2. 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.\r\n    - 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.\r\n    - 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`).\r\n    - 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`).\r\n    - 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.\r\n    - 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.\r\n    - 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.\r\n    - 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.\r\n    - 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.\r\n    - 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__.\r\n    - 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.\r\n    - 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.\r\n    - If you have loaded an ICC profile or have done a custom display calibration (Control Panel \u003e Color Management \u003e 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).\r\n    - If you loathe the fading transition upon start-up, just set `nofading=1`.\r\n    - 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.\r\n    - 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.\r\n    - 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.\r\n    - 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`.\r\n    - 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.\r\n3. Now save the settings file and close it. Redshift Tray will restart with the settings you've defined.\r\n4. 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_.\r\n5. 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.\r\n\r\nYou. Are. Done!\r\n\r\n## Credits\r\n* [Redshift](https://github.com/jonls/redshift) by [Jon Lund Steffensen](https://github.com/jonls)\r\n* 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)  \r\n* [AutoHotkey](https://www.autohotkey.com), a scripting language for desktop automation by Chris Mallet and others.  \r\n* [Redshift](https://github.com/jonls/redshift) by [Jon Lund Steffensen](https://github.com/jonls)\r\n* [ipapi](https://ipapi.co) by Kloudend, Inc. ([Privacy Policy](https://ipapi.co/privacy))\r\n* [Chocolatey package](https://chocolatey.org/packages/rstray) by [tunisiano187](https://github.com/tunisiano187)\r\n* [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)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fltguillaume%2Fredshift-tray","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fltguillaume%2Fredshift-tray","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fltguillaume%2Fredshift-tray/lists"}