first commit

This commit is contained in:
2026-02-16 22:32:35 +08:00
commit bcdd19df21
13 changed files with 1060 additions and 0 deletions

54
README.html Normal file
View File

@@ -0,0 +1,54 @@
<html>
<head>
<title>HDRTray</title>
<style>body { font-family: sans-serif; }</style>
</head>
<body>
<h1>HDRTray</h1>
<p>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.</p>
<h2>Usage</h2>
<p>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.</p>
<p>HDR can be toggled on or off with a left-click on the icon.</p>
<p>Right-clicking opens the context menu offering an option to automatically start
the program when you log in to Windows.</p>
<h2>Command line utility</h2>
<p>Since version 0.5, the <code>HDRCmd</code> command line utility is included. It can be used to toggle HDR on and off from scripts and check it's status.</p>
<p>Syntax:</p>
<pre><code>HDRCmd [SUBCOMMAND] [SUBCOMMAND-OPTIONS]
</code></pre>
<h2><code>on</code> command</h2>
<p>Turns HDR on on all supported displays.</p>
<p>Does not accept any options.</p>
<h2><code>off</code> command</h2>
<p>Turns HDR off on all supported displays.</p>
<p>Does not accept any options.</p>
<h2><code>status</code> command</h2>
<p>Prints the current HDR status to the console. Has a special mode that returns an exit code depending on the status.</p>
<h3><code>--mode</code> (<code>-m</code>) option</h3>
<p>Specifies how the status should be reported. Accepts the following values:</p>
<ul>
<li><code>short</code>, <code>s</code> (default): Print a single line indicating the overall HDR status.</li>
<li><code>long</code>, <code>l</code>: Print the overall HDR status and status per display.</li>
<li><code>exitcode</code>, <code>x</code>: 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.)</li>
</ul>
<h2>Latest Release</h2>
<p>The latest release can be found on the <a href="https://github.com/res2k/HDRTray/releases">“Releases” tab of the GitHub project page</a>.</p>
<h2>Feedback, Issues</h2>
<p>Please use the <a href="https://github.com/res2k/HDRTray/issues">“Issues” tab of the GitHub project page</a> to provide feedback or report any issues you may encounter.</p>
<h2>License</h2>
<p>HDRTray, a notification icon for the “Use HDR” option</p>
<p>Copyright (C) 2022-2023 Frank Richter</p>
<p>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.</p>
<p>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.</p>
<p><a href="LICENSE.md.html">Full text of GNU General Public License, Version 3</a>.</p>
</body>
</html>