A comprehensive Windows application for setting custom monitor resolutions with safety features and ease of use. Built specifically to solve real-world multi-monitor alignment issues.
I created this application because I needed to tweak my Surface Book 2 to support better alignment with my external monitor. The default Windows apps and third-party tools were either too complex, unsafe, or simply didn't work reliably for this task. This tool was built out of necessity and I hope it helps others facing similar multi-monitor challenges.
- Safe Resolution Testing: 15-second test mode with automatic rollback
- Multi-Monitor Support: Detect and manage multiple displays
- Smart Screen Fill Detection: Visual indicators (✓, ⚠, ★) for resolutions that can fill the entire screen
- Progressive Compatibility: Intelligent fallback for unsupported resolutions
- Current Resolution Detection: Automatically reads and displays current monitor settings
- Quick Presets: One-click access to common resolutions (HD, Full HD, 2K, 4K)
- Responsive UI: 3-column layout that adapts to different screen sizes
- Administrative Safety: Requires admin privileges for system-level changes
- Windows 10/11
- .NET 6.0 Runtime
- Administrative privileges
- Download the latest release from the Releases page
- Extract the ZIP file
- Right-click
ResolutionTweak.exe
and select "Run as administrator"
- Select Monitor: Choose your target display from the dropdown
- View Supported Resolutions: Browse the list of available resolutions with fill indicators
- Set Custom Resolution:
- Single-click any resolution to populate the custom fields
- Double-click to set and apply immediately
- Test Before Applying: Use the "Test Resolution" button for a 15-second preview
- Apply Permanently: Use "Apply Resolution" to make changes permanent
- Quick Reset: Use "Reset to Original" to restore your previous settings
- Visual Studio 2022 or .NET 6.0 SDK
- Windows 10/11 development environment
# Clone the repository
git clone https://github.com/yourusername/Resolution-Tweak.git
cd Resolution-Tweak
# Build Debug version
dotnet build ResolutionTweak/ResolutionTweak.csproj --configuration Debug
# Build Release version
dotnet build ResolutionTweak/ResolutionTweak.csproj --configuration Release
# Run Debug version (includes console output)
ResolutionTweak\bin\Debug\net6.0-windows\ResolutionTweak.exe --debug-resolution
# Run Release version
ResolutionTweak\bin\Release\net6.0-windows\ResolutionTweak.exe
- Test Mode: All resolution changes start with a 15-second test period
- Automatic Rollback: Changes automatically revert if not confirmed
- Input Validation: Comprehensive validation of resolution parameters
- Error Handling: Graceful handling of unsupported resolutions
- Admin Requirements: Prevents accidental system changes
- 3-Column Layout: Efficient use of screen space
- Responsive Design: Adapts to different monitor sizes
- Visual Indicators: Clear feedback for screen fill compatibility
- Status Updates: Real-time feedback on all operations
- Tooltips: Helpful hints for all major functions
For developers and troubleshooting, run with the --debug-resolution
flag to enable console output and detailed resolution detection logging.
The application automatically detects all resolutions supported by your graphics card and monitor combination, including:
- Standard resolutions (HD, Full HD, 2K, 4K)
- Custom resolutions
- Various refresh rates (60Hz, 75Hz, 120Hz, etc.)
- Different color depths (24-bit, 32-bit)
Contributions are welcome! Please feel free to submit issues, feature requests, or pull requests.
- Follow existing code style
- Add appropriate error handling
- Test on multiple monitor configurations
- Update documentation for new features
This project is licensed under the MIT License - see the LICENSE file for details.
This tool modifies system display settings and requires administrative privileges. While it includes safety features, use at your own risk. Always test resolutions before applying them permanently.
- Built with WPF and .NET 6.0
- Uses Windows Display API for reliable resolution management
- Inspired by the need for better multi-monitor management tools
If you encounter issues or have questions:
- Check the Issues page
- Create a new issue with detailed information
- Include your Windows version, monitor configuration, and error details
Made with ❤️ for the Windows community. If this tool helps you, please consider giving it a star!