Skip to content

yinjunonly/hdr-sdr-brightness

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HDR SDR Brightness

English | 中文

English

HDR SDR Brightness is a lightweight Windows tray app for keeping SDR content brightness predictable when Windows HDR is enabled.

It is built for OLED, QD-OLED, MiniLED, HDR monitors, HDR TVs, and HDR laptop panels where regular SDR apps may look too bright, too dim, or washed out after HDR is turned on.

Clean, efficient, and intuitive light and dark interfaces

Get it from Microsoft

Download

Install from the Microsoft Store, or download the portable package from GitHub Releases.

Use the Windows x64 package:

HdrSdrBrightness-1.0.9-win64.zip

Extract the archive and run HdrSdrBrightness.exe. The app is portable: no installer, no service, and no administrator privileges are required.

What's New In 1.0.9

  • Adds HDR screenshot capture powered by Windows Graphics Capture, aimed at avoiding the blown-out or overexposed results common with regular screenshot tools on HDR displays.
  • Copies selected screenshots to the clipboard by default, with quick save and lightweight annotation controls.
  • Adds a compact screenshot hotkey settings dialog for region and fullscreen capture shortcuts. Defaults are Alt+S for region capture and Shift+Alt+S for fullscreen capture.
  • Refines the settings layout, card padding, HDR/SDR preview alignment, and popup layering.

HDR screenshot capture workflow

Common Use Cases

  • Windows HDR makes SDR desktop apps look too bright, too dim, or washed out.
  • You use an OLED, QD-OLED, MiniLED, HDR monitor, HDR TV, or HDR laptop panel and want separate day/night SDR brightness.
  • You want lightweight Windows HDR SDR brightness control without drivers, services, or a heavy background process.

What It Does

  • Applies your preferred Windows SDR content brightness while HDR is active.
  • Supports separate Day and Night SDR brightness levels.
  • Can follow Windows Night Light, or use a built-in fallback schedule.
  • Restores the configured SDR brightness if a manual change is detected.
  • Provides a live SDR/HDR preview in the settings window.
  • Captures HDR screenshots that are less prone to the overexposed or washed-out look produced by many regular screenshot tools, with region selection, fullscreen capture, clipboard copy, save, and simple annotations.
  • Links to Microsoft's Windows HDR Calibration app for display-level HDR calibration.
  • Runs quietly from the system tray and can start with Windows.
  • Follows the Windows light/dark app theme automatically.
  • Supports Auto, Simplified Chinese, Traditional Chinese, English, Korean, Japanese, Russian, and German.

Design And Interaction

HDR SDR Brightness is designed to feel simple in daily use: open it, choose comfortable day and night SDR brightness, then let it stay out of the way in the tray.

The interface follows the Windows light or dark app theme automatically. Cards group related settings, sliders make brightness easy to compare, switches show on/off state clearly, and the SDR/HDR preview gives immediate visual feedback before you apply changes.

Small interactions are kept responsive and restrained: buttons and controls react to the pointer with soft reveal highlights, dropdowns and brightness changes transition smoothly, and the Support author entry has a subtle motion cue without distracting from the main settings.

Recommended Defaults

Setting Default
Day SDR content brightness 40%
Night SDR content brightness 25%
Switching mode Follow Windows Night Light when available
Fallback schedule Night starts at 18:00, day starts at 08:00
Restore manual changes On
Region screenshot hotkey Alt+S
Fullscreen screenshot hotkey Shift+Alt+S

These values are only starting points. Tune them for your panel, room lighting, and preferred SDR white level.

Early community feedback and reported SDR brightness ranges are collected in docs/feedback.md.

When SDR Brightness Is Not Enough

This app adjusts the Windows SDR content brightness level while HDR is enabled. If your HDR display is still washed out, clips highlights, has incorrect peak brightness, or looks wrong even after changing SDR brightness, also run Microsoft's official Windows HDR Calibration app:

https://apps.microsoft.com/detail/9n7f2sm5d1lr?hl=en-US&gl=US

Microsoft's calibration app is useful for display-level HDR calibration, while HDR SDR Brightness is focused on day/night SDR content brightness control. They are complementary tools.

When an HDR display is detected, HDR SDR Brightness also provides quick access to Windows HDR Calibration from the tray menu and from the settings window.

Tray Usage

Run HdrSdrBrightness.exe to open Settings and keep the app in the tray.

Run HdrSdrBrightness.exe --background for tray-only startup. This is the mode used by Start with Windows.

The tray menu includes Apply now, Capture HDR screenshot, Settings, Start with Windows, Display settings, Night Light settings, Windows HDR Calibration, Support author, and Exit.

Support The Author

If this app improves your HDR setup, you can support development on Afdian:

https://afdian.com/a/injunaid/plan

Supporter codes only show a small local badge. They are optional and do not unlock features.

Background Performance

Background idle performance profile

Measured with the settings window closed and the app running in --background tray mode:

Metric Result
Sample duration 60 seconds
Average CPU 0.0000%
Peak CPU 0.0000%
Average working set 13.8 MB
Peak working set 13.8 MB
Average private memory 3.0 MB
Peak private memory 3.0 MB
Average handles 195
Average threads 5

Sampling method: 1 second process samples after a 5 second warm-up. CPU is calculated from TotalProcessorTime deltas and normalized across 12 logical processors. Actual values can vary by display count, HDR state, Windows build, GPU driver, and hardware.

The background path is designed to stay quiet:

  • Settings UI resources are loaded only while Settings is open.
  • Animation timers are started on demand and stopped when idle.
  • Startup state is not queried in the 15 second brightness correction path.
  • Windows Night Light state is cached and refreshed through registry notifications.

Privacy And Startup

Configuration is stored for the current Windows user:

HKCU\Software\OledHdrSdrSync

In the portable desktop build, Start with Windows uses the current-user Run key:

HKCU\Software\Microsoft\Windows\CurrentVersion\Run\HdrSdrBrightness

The Microsoft Store build uses the packaged Windows startup task and reflects the current state from Windows Settings > Apps > Startup.

The app does not create a service and does not require administrator privileges. When Windows denies scheduled task creation in the portable build, the current-user Run entry remains the startup path.

Supporter-code validation is local and offline.

Source Code

The source code is available in this repository for transparency and community review. Most people should install from the Microsoft Store or use the release ZIP rather than building the app themselves.

License

MIT License. See LICENSE.

Search Keywords

Windows HDR SDR brightness
Windows HDR SDR content brightness
Windows SDR content brightness
HDR SDR brightness balance
HDR/SDR brightness balance
SDR content brightness slider
SDR content brightness too bright
SDR content too dark in HDR
Windows HDR washed out
Windows 11 HDR washed out
Auto HDR washed out
OLED HDR brightness
QD-OLED HDR brightness
MiniLED HDR brightness
HDR monitor SDR brightness
HDR TV Windows SDR brightness
Windows Night Light SDR brightness
SDR white level

中文

HDR SDR 亮度助手 是一个轻量的 Windows 托盘工具,用来在开启 Windows HDR 时,让 SDR 内容亮度 保持稳定、舒适、可预期。

它适合 OLED、QD-OLED、MiniLED、HDR 显示器、HDR 电视和支持 HDR 的笔记本屏幕。开启 HDR 后,如果普通 SDR 软件看起来过亮、过暗或发灰,可以用它自动切换和修正 SDR 内容亮度。

简洁、高效、直观的浅色与深色界面

从 Microsoft 获取

下载

可以从 Microsoft Store 安装,也可以从 GitHub Releases 下载便携版。

Windows x64 用户下载:

HdrSdrBrightness-1.0.9-win64.zip

解压后运行 HdrSdrBrightness.exe。这是便携程序:不需要安装,不创建服务,也不需要管理员权限。

1.0.9 更新内容

  • 新增基于 Windows Graphics Capture 的 HDR 截图,用来缓解普通截图工具在 HDR 显示器上容易截出过曝、发白、丢高光的问题。
  • 区域截图默认复制到剪贴板,并提供快速保存、轻量标注和马赛克工具。
  • 新增紧凑的截图快捷键设置弹窗,可单独修改区域截图和全屏截图快捷键;默认区域截图为 Alt+S,默认全屏截图为 Shift+Alt+S
  • 继续优化设置页布局、卡片内边距、HDR/SDR 预览对齐和弹层遮挡问题。

HDR 截图捕获流程

常见使用场景

  • 开启 Windows HDR 后,SDR 桌面应用看起来过亮、过暗或发灰。
  • 你正在使用 OLED、QD-OLED、MiniLED、HDR 显示器、HDR 电视或 HDR 笔记本屏幕,并希望分别设置白天/夜间 SDR 亮度。
  • 你需要一个轻量的 Windows HDR SDR 亮度调节工具,不安装驱动、不创建服务,也不常驻重型后台进程。

它能做什么

  • HDR 开启时自动应用你设定的 Windows SDR 内容亮度。
  • 支持单独设置 白天夜间 SDR 内容亮度。
  • 可以跟随 Windows 夜间模式,也可以使用内置默认时段。
  • 检测到手动修改 SDR 内容亮度后,可以自动恢复到配置值。
  • 设置页提供 SDR/HDR 实时预览。
  • 支持 HDR 截图:相比很多普通截图工具,更不容易把 HDR 画面截得过曝或发白,并提供区域选择、全屏捕获、剪贴板复制、保存和简单标注。
  • 提供微软 Windows HDR Calibration 入口,用于显示器级 HDR 校准。
  • 常驻系统托盘,并支持开机后安静启动。
  • 自动跟随 Windows 应用浅色/深色主题。
  • 支持自动、简体中文、繁体中文、English、한국어、日本語、Русский、Deutsch。

设计与交互

HDR SDR 亮度助手的设计目标是日常使用足够简单:打开后设置好白天和夜间 SDR 亮度,之后让它安静留在托盘里自动工作。

界面会自动跟随 Windows 浅色或深色应用主题。卡片负责整理设置分区,滑块方便直观看到亮度差异,开关清楚表达开启/关闭状态,SDR/HDR 预览则让你在应用设置前先看到变化。

交互效果尽量克制但有反馈:按钮和控件会跟随鼠标出现柔和高光,下拉菜单和亮度预览有平滑过渡,“支持作者”入口有轻微动态提示,但不会干扰主要设置。

推荐默认值

设置 默认值
白天 SDR 内容亮度 40%
夜间 SDR 内容亮度 25%
切换方式 优先跟随 Windows 夜间模式
默认时段 18:00 进入夜间,08:00 进入白天
自动纠正手动调整 开启
区域截图快捷键 Alt+S
全屏截图快捷键 Shift+Alt+S

这些只是起点。你可以根据屏幕类型、房间光线和自己习惯的 SDR 白点继续调整。

早期社区反馈和用户提到的 SDR 亮度范围整理在 docs/feedback.md

SDR 亮度仍然不够时

本工具调整的是 HDR 开启时 Windows 的 SDR 内容亮度。如果调整 SDR 亮度后,屏幕仍然发灰、高光过曝、峰值亮度不准,或 HDR 整体观感仍然异常,建议同时使用微软官方 Windows HDR Calibration 应用进行 HDR 校准:

https://apps.microsoft.com/detail/9n7f2sm5d1lr?hl=zh-CN&gl=US

微软的校准应用更适合处理显示器级别的 HDR 校色和峰值亮度配置;HDR SDR 亮度助手则负责日夜模式下的 SDR 内容亮度控制。两者是配套关系。

检测到 HDR 显示器后,HDR SDR 亮度助手也会在托盘菜单和设置窗口中提供 Windows HDR Calibration 快捷入口。

托盘使用

运行 HdrSdrBrightness.exe 会打开设置页,同时程序留在系统托盘。

运行 HdrSdrBrightness.exe --background 会只进入托盘;开机自启使用这个模式。

托盘菜单包含:立即应用、截取 HDR 截图、设置、开机自启、打开显示设置、打开夜间模式设置、Windows HDR Calibration、支持作者、退出。

支持作者

如果这个工具改善了你的 HDR 使用体验,可以通过爱发电支持作者:

https://afdian.com/a/injunaid/plan

支持者码只会显示一个本地小徽章,是可选的,不会解锁功能,也不影响正常使用。

后台性能

后台空闲性能

以下数据来自设置窗口关闭、程序以 --background 托盘模式运行时的采样:

指标 结果
采样时长 60 秒
平均 CPU 0.0000%
峰值 CPU 0.0000%
平均工作集内存 13.8 MB
峰值工作集内存 13.8 MB
平均私有内存 3.0 MB
峰值私有内存 3.0 MB
平均句柄数 195
平均线程数 5

采样方式:预热 5 秒后,每 1 秒读取一次进程数据。CPU 使用进程 TotalProcessorTime 增量计算,并按 12 个逻辑处理器归一化。实际占用会随显示器数量、HDR 状态、Windows 版本、显卡驱动和硬件环境变化。

后台路径尽量保持安静:

  • 设置页绘制资源只在设置窗口打开时加载。
  • 动画计时器按需启动,空闲后停止。
  • 开机自启状态不会放进每 15 秒亮度检查路径。
  • Windows 夜间模式状态会缓存,并由注册表通知刷新。

隐私与自启动

配置保存在当前 Windows 用户注册表:

HKCU\Software\OledHdrSdrSync

便携桌面版开机自启使用当前用户 Run 项:

HKCU\Software\Microsoft\Windows\CurrentVersion\Run\HdrSdrBrightness

Microsoft Store 版使用 Windows 打包启动任务,并会从 Windows 设置 > 应用 > 启动 同步当前状态。

程序不创建服务,也不需要管理员权限。如果便携版遇到 Windows 拒绝创建计划任务,会继续使用当前用户 Run 项作为启动方式。

支持者码为本地离线校验。

源代码

本仓库公开源代码,方便查看和审阅。大多数用户建议直接从 Microsoft Store 安装,或下载 Release ZIP 包,不需要自己构建。

开源许可

MIT License,详见 LICENSE

搜索关键词

Windows HDR 自动亮度
Windows HDR SDR 亮度
Windows SDR 内容亮度
Windows SDR 内容亮度滑块
HDR 下 SDR 内容过亮
HDR 下 SDR 内容过暗
HDR 开启后颜色发灰
HDR 发灰
HDR 洗白
Auto HDR 发灰
OLED HDR 太亮
OLED HDR 太暗
QD-OLED HDR 亮度
MiniLED HDR 亮度
HDR 显示器 SDR 亮度
HDR 电视 Windows SDR 亮度
Windows 夜间模式 SDR 亮度
SDR White Level