Skip to content

About

Align your mouse cursor across Windows multi-monitor setups with different screen sizes, resolutions, and DPI. On-screen rulers, live cursor correction, and a manual display layout guide. C# / .NET 8 / WPF.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

ScreenEdge Align: align a mouse cursor across monitors using screen-edge rulers

ScreenEdge Align

Different screens. One continuous cursor.
Mouse cursor alignment for Windows multi-monitor setups with different screen sizes and resolutions.

Windows 10 / 11 .NET 8 WPF Version 1.1.0 51 of 51 local automated tests passed

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.

Features

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.

Quick start

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.

  1. Run ScreenEdgeAlign.exe. Cursor correction is off on first launch.
  2. 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.
  3. Open mouse boundary calibration and drag each colored reference line to the same physical height across your displays.
  4. 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.

Choose how to align your displays

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

Windows display layout 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.

Controls

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 from source

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 -Publish

Output: 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 dist

These 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"

Validation and limitations

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).

How it works

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 and feedback

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).

About

Align your mouse cursor across Windows multi-monitor setups with different screen sizes, resolutions, and DPI. On-screen rulers, live cursor correction, and a manual display layout guide. C# / .NET 8 / WPF.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages