Skip to content

res2k/HDRTray

Repository files navigation

HDRTray

Windows Notification Area icon to show and change HDR status. Useful if you quickly want to check the current setting, maybe because it might been changed automatically by some applications, or maybe just because you're forgetful. Also allows quick toggling.

Usage

After starting the program you can see a new notification area icon, displaying either “SDR” or “HDR” depending on whether HDR is off or on.

HDR can be toggled on or off with a left-click on the icon.

Right-clicking opens the context menu offering an option to automatically start the program when you log in to Windows.

Command line utility

Since version 0.5, the HDRCmd command line utility is included. It can be used to toggle HDR on and off from scripts and check it's status.

Syntax:

HDRCmd [SUBCOMMAND] [SUBCOMMAND-OPTIONS]

on command

Turns HDR on on all supported displays.

Does not accept any options.

off command

Turns HDR off on all supported displays.

Does not accept any options.

status command

Prints the current HDR status to the console. Has a special mode that returns an exit code depending on the status.

--mode (-m) option

Specifies how the status should be reported. Accepts the following values:

  • short, s (default): Print a single line indicating the overall HDR status.
  • long, l: Print the overall HDR status and status per display.
  • exitcode, x: Special mode for scripting. Exit code is 0 if HDR is on, 1 if HDR is off, and 2 if HDR is unsupported. (Other values indicate some error.)

Latest Release

The latest release can be found on the “Releases” tab of the GitHub project page.

Feedback, Issues

Please use the “Issues” tab of the GitHub project page to provide feedback or report any issues you may encounter.

License

HDRTray, a notification icon for the “Use HDR” option

Copyright (C) 2022-2023 Frank Richter

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Full text of GNU General Public License, Version 3.