Different screens. One continuous cursor.
Mouse cursor alignment for Windows multi-monitor setups with different screen sizes and resolutions.
Quick start · Windows layout guide · Build · Validation · 한국어 사용 설명서
Does your mouse pointer jump up or down when moving between monitors?
ScreenEdge Align is a Windows desktop utility for aligning mouse cursor movement across dual-monitor and multi-monitor setups. Drag screen-edge rulers to match a reference line at the same physical height, then correct the cursor's vertical position as it crosses between displays with different sizes, resolutions, or pixel densities.
For a setup that does not need a background app, the Windows display layout guide shows how to manually reposition monitor rectangles in Windows Settings to align the reference height.
Built with C# / .NET 8 / WPF. Settings stay on your computer. The app does not record clicks or keystrokes, make network requests, or automatically change Windows resolution, scaling, or display layout.
The banner is a concept illustration, not an app screenshot. The test badge reports local automated tests, not a hosted CI run. The current app interface is in Korean; English action names below describe the corresponding controls. See the Korean user guide for exact UI labels.
| Feature | What it does |
|---|---|
| On-screen calibration | Drag reference lines directly along the inner edges of your physical displays. |
| Physical cursor alignment | Use display height and pixel count to map cursor movement across monitor boundaries. Windows scaling is not used as a substitute for physical size. |
| Mixed monitor setups | Handle mixed DPI, portrait displays, negative desktop coordinates, and three or more displays arranged side by side. |
| Windows display layout guide | Compare current and recommended layouts, with target coordinates and directions such as “move up 120 px.” |
| Local profiles | Save calibration and layout targets as JSON for each monitor configuration. |
| System tray controls | Keep correction running with the main window closed, toggle it from the tray, and optionally start with Windows. |
| Emergency stop | Disable cursor correction with Ctrl + Alt + F12. |
Requirements: Windows 10/11, x64. A self-contained build runs without installing .NET separately or requesting administrator privileges. To create the executable from this repository, follow Build from source.
- Run
ScreenEdgeAlign.exe. Cursor correction is off on first launch. - Check each display's physical height. If the EDID estimate is inaccurate, enter the height of the visible screen area, excluding the bezel, in mm, cm, or inches.
- Open mouse boundary calibration and drag each colored reference line to the same physical height across your displays.
- Apply the calibration and enable correction. Closing the main window leaves the app running in the system tray.
To exit completely, choose Exit from the tray menu. Before updating, exit the previous instance and then launch the new executable. Version 1.1 can read existing version 1.0 settings.
| Live cursor correction | Windows layout guide | |
|---|---|---|
| Action | Apply and enable correction | Save guide only |
| Aligns | Reference height and differences in physical pixel size | Reference height in the Windows desktop layout |
| Background app | Required while correction is active | Not required after you apply the layout in Windows |
| Windows layout | Unchanged | You move the rectangles manually using the guide |
New in v1.1: turn your saved reference lines into a suggested Windows monitor arrangement.
Align reference lines on your physical displays
↓
Save guide only
↓
Compare current and recommended layouts
↓
Move monitor rectangles in Windows Settings
↓
Apply, then recheck the remaining offsets
- Keep the primary display fixed while calculating target X/Y coordinates and vertical offsets for the other displays.
- Open Windows Display Settings and use Identify to match the display numbers. App indices and device-name suffixes are not assumed to match Windows display numbers.
- Follow the suggested offsets in desktop pixels. They are not the distance to drag on the scaled-down Settings diagram.
- Save the target layout for comparison after manual changes or an app restart.
- Disable live correction while testing the Windows arrangement, so the app's correction does not affect the comparison.
What layout changes can achieve: moving monitor rectangles can align the reference height. It cannot remove differences in physical pixel size between displays, so alignment may drift farther from the reference line. Use live cursor correction to account for those differences.
| Input | Action |
|---|---|
| Drag a reference line or ruler | Move the reference line |
Shift + drag |
Fine adjustment at 1/10 speed |
↑ / ↓ |
Move by 1 px |
Shift + ↑ / ↓ |
Move by 10 px |
Esc |
Cancel calibration edits |
Ctrl + Alt + F12 |
Emergency stop for cursor correction |
| Double-click the tray icon | Open the settings window |
Build requirements: Windows and the .NET 8 SDK. No additional third-party NuGet packages are used.
Run PowerShell in the project directory:
# Release build and automated tests
.\build.ps1
# Build a self-contained, single-file Windows x64 executable
.\build.ps1 -PublishOutput: dist/ScreenEdgeAlign.exe
Direct build commands and diagnostic options
dotnet build src/ScreenEdgeAlign/ScreenEdgeAlign.csproj -c Release
dotnet run --project tests/ScreenEdgeAlign.Tests -c Release
dotnet publish src/ScreenEdgeAlign/ScreenEdgeAlign.csproj `
-c Release -r win-x64 --self-contained true `
-p:PublishSingleFile=true `
-p:IncludeNativeLibrariesForSelfExtract=true `
-p:EnableCompressionInSingleFile=true `
-p:DebugType=None -p:DebugSymbols=false -o distThese diagnostics do not move the cursor. The output directory must already exist. Diagnostic display reports may contain device identifiers; remove unnecessary identifiers before sharing them publicly.
.\dist\ScreenEdgeAlign.exe --diagnose "$env:TEMP\screenedge-displays.json"
.\dist\ScreenEdgeAlign.exe --self-test "$env:TEMP\screenedge-native-test.json"| Check | Status |
|---|---|
| Coordinate transforms, boundary detection, settings, and layout calculations | 51/51 local automated tests passed |
| Windows x64 Release and single-file executable | Built successfully |
| Win32 monitor, EDID, and DPI detection | Checked with a three-display setup |
| Mouse hook and Raw Input registration/disposal | v1.0 native smoke test passed |
| Actual GUI interaction with the v1.1 layout guide | Not yet verified |
| Varied physical layouts, high refresh rates, and remote sessions | Further testing needed |
- Cursor correction supports side-by-side extended displays with touching X edges in the virtual desktop. Vertical-only layouts, mirroring, and horizontal gaps are not automatically connected.
- EDID dimensions are estimates. Measure the visible screen area when the detected size is incorrect.
- Absolute-position input devices, secure desktops, and some remote environments have limitations.
- Automated tests and native registration checks do not replace hands-on testing of ruler dragging or physical cursor crossings.
See the detailed validation record and manual checklist (Korean).
Each display's physical height and reference line define a shared physical coordinate system. Movement within one display is unchanged. On a horizontal boundary crossing, the app maps the cursor's Y coordinate to the neighboring display:
physicalY = (sourceY − sourceTop) / sourcePixelsPerMm + sourceOffsetMm
targetY = targetTop + (physicalY − targetOffsetMm) × targetPixelsPerMm
Project structure
src/
├── ScreenEdgeAlign.Core/ Coordinate mapping, profiles, and layout calculations
└── ScreenEdgeAlign/
├── Calibration/ Screen-edge rulers and reference-line dragging
├── Cursor/ Input thread, mouse hook, and Raw Input
├── Display/ Monitor detection, EDID, DPI, and Win32 APIs
├── Guide/ Layout diagrams, instructions, and target comparison
├── Settings/ Optional Windows startup registration
└── Tray/ System tray controls
tests/
└── ScreenEdgeAlign.Tests/ Regression tests without external test packages
Settings are stored at %LOCALAPPDATA%/ScreenEdgeAlign/settings.json. SDK files, personal settings, intermediate build files, and distribution executables are excluded from the source repository.
Report a bug or request a feature. Include your Windows version, monitor resolutions, scaling, rotation, arrangement, steps to reproduce, and expected behavior. Omit private device identifiers and personal paths.
For development and contribution guidance, see CONTRIBUTING.md (Korean).