Fix blurry UI on Windows high-DPI displays#3
Merged
Conversation
Co-authored-by: bryfur <7673964+bryfur@users.noreply.github.com>
…tant Co-authored-by: bryfur <7673964+bryfur@users.noreply.github.com>
Copilot
AI
changed the title
[WIP] Improve DPI scaling for better clarity on Windows
Fix blurry UI on Windows high-DPI displays
Dec 28, 2025
bryfur
marked this pull request as ready for review
December 28, 2025 19:47
There was a problem hiding this comment.
Pull request overview
This PR fixes blurry UI rendering on Windows high-DPI displays (150%/200% scaling) by implementing DPI awareness at both runtime and build time. The solution uses a defense-in-depth approach: runtime code handles execution from source, while the manifest handles built executables.
Key Changes:
- Added runtime DPI awareness detection with fallback chain supporting Windows Vista through Windows 10 1703+
- Created application manifest declaring
PerMonitorV2DPI awareness for built executables - Integrated manifest embedding into the Windows build process via PyInstaller
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.
| File | Description |
|---|---|
| wow_sync/main.py | Adds enable_dpi_awareness() function with cascading fallbacks for DPI awareness APIs, called before Tk initialization |
| wow_sync.manifest | Defines DPI awareness settings (both legacy dpiAware and modern PerMonitorV2) for Windows executable |
| build.py | Integrates manifest into Windows builds using PyInstaller's --manifest flag |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Tkinter applications on Windows appear blurry on high-DPI displays (150%/200% scaling) because Windows applies bitmap scaling to DPI-unaware applications.
Changes
Runtime DPI awareness: Added
enable_dpi_awareness()in__main__.pycalled before Tk initializationSetProcessDpiAwarenessContext(PER_MONITOR_AWARE_V2)(Win10 1703+)SetProcessDpiAwareness(PROCESS_PER_MONITOR_DPI_AWARE)(Win8.1+)SetProcessDPIAware()(Vista+)Build-time manifest: Created
wow_sync.manifestdeclaringdpiAwareness: PerMonitorV2for PyInstaller executableBuild configuration: Updated
build.pyto embed manifest on Windows builds via--manifestflagWindows-only changes. No impact on macOS/Linux.
Original prompt
✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.