Skip to content

docs: add Troubleshooting section for dim screen captures and slider brightness jump - #1913

Open
ankitdhandharia wants to merge 1 commit into
MonitorControl:mainfrom
ankitdhandharia:docs/troubleshooting-dim-captures
Open

ankitdhandharia wants to merge 1 commit into
MonitorControl:mainfrom
ankitdhandharia:docs/troubleshooting-dim-captures

Conversation

@ankitdhandharia

Copy link
Copy Markdown

What

Adds a Troubleshooting section to the README covering the two most frequently repeated support questions for displays without hardware (DDC) control:

  1. Screenshots / screen recordings / screen sharing look dim — explains that shade-overlay dimming is captured while gamma-table dimming is not, and how to fix it by turning off Avoid gamma table manipulation.
  2. Brightness jumps suddenly at a point on the slider — explains the software/hardware dimming handover on non-DDC displays and the same fix.

Why

The README has no Troubleshooting/FAQ section, yet these two questions recur often in Issues and Discussions and are answered the same way each time by the maintainer, e.g. #1446, #1252, #1388, and discussions #1453 / #1189. Documenting the cause and the one-setting fix in the README should reduce repeat questions and help users self-serve.

This is docs only (README.md); no code changes. It is complementary to the open code fix in #1877 (which excludes the overlay from capture for real displays) — the docs also cover the gamma default and the slider-jump case, which that PR does not.

Testing

Documentation change only. Rendered Markdown reviewed for correct formatting and links.

Document why software-dimmed non-DDC displays appear dull in
screenshots, screen recordings, and screen sharing (shade overlay is
captured; gamma dimming is not), and how to fix it by disabling
'Avoid gamma table manipulation'. Also explain the sudden brightness
change at the software/hardware dimming handover on non-DDC displays.

These are among the most frequently repeated support questions in
Discussions/Issues; the README previously had no Troubleshooting or
FAQ section covering them.
@waydabber waydabber added the in progress Issue currently being worked on label Sep 26, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

in progress Issue currently being worked on

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants