Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/r-larch/mousetrap

A small tool to map the cursor between monitors with different DPIs
https://github.com/r-larch/mousetrap

cursor-moves cursor-position dpi-awareness dpi-scaling mouse-pointer multiscreen screen-scale

Last synced: about 2 months ago
JSON representation

A small tool to map the cursor between monitors with different DPIs

Awesome Lists containing this project

README

        

# MouseTrap

[![Build](https://github.com/r-Larch/MouseTrap/actions/workflows/build.yml/badge.svg)](https://github.com/r-Larch/MouseTrap/actions/workflows/build.yml)

MouseTrap is a small tool to map the cursor between multiple monitors with

different resolutions and scaling settings.

## Min requirements

For this tool to function correctly you should have:

- At least **Windows 10 Creators update** (Build 1703)
- [**.NET 8 Runtime**](https://dotnet.microsoft.com/en-us/download/dotnet/8.0) (in most cases it will notify you if the runtime is missing)

## Download and Setup

You can find the latest release here:
> [Download](https://github.com/r-Larch/MouseTrap/releases)

You can install MouseTrap with **chocolatey**:
```Powershell
# install the package
choco install mousetrap

# running it
mousetrap
```

## Changelog

### Version 1.0.20
- Add `chocolatey` support

### Version 1.0.19

- **Migrate to .NET 8**
- Discontinue `chocolatey` support
- Migrate CI to Github Actions
- Bug fixes

### Version 1.0.15

- **Migrate to .NET 6**
- Bug fixes

### Version 1.0.6

- **Migrate to .NET 5** _(from legacy .NET Framework)_
- Adds **Diagnostic Window**
- Realtime Log Viewer
- Configutation Viewer
- LogFile Viewer
- Implements a **potential fix** for **[#2 Unexpected Cursor Teleportation](https://github.com/r-Larch/MouseTrap/issues/2)**
- Adds an option to **disable Mouse teleportation** - That's usefull while gaming in fullscreen!
- Lots of smaller bugfixes

## Usage and Configuration

You can always find your running **MouseTrap** app as a system-tray icon in the right corner of your Taskbar.
Right-clicking the icon shows some options:

Option | Description
--------------------|------------------------------------------------------------------
**Settings** | Open configuration screen
Mouse teleportation | **Checkbox** Turn off mouse teleportation e.g. while gaming
Exit | Fully exit MouseTrap process

_NOTE: reinit can be triggered by commandline:_ `mousetrap --reinit`

![Tray icon](https://raw.githubusercontent.com/r-Larch/MouseTrap/master/images/tray-snap.jpg)

Hit **Settings** on the menu and you see a screen like in the following picture, where you can see your monitors and their alignment.
or better how Windows sees them. *(Windows has no clue how big your screens are).*


Hit **Configure Screen Bridges** to configure how this tool maps your mouse pointer between Monitors.

And don't forget to check the checkbox on the left, if it isn't already, to ensure MouseTrap starts automatically
if your computer turns off and on again.

![Settings Screen](https://raw.githubusercontent.com/r-Larch/MouseTrap/master/images/settings-screen.jpg)

### Configure Screen Bridges

On the configuration, screen hit the '**+**' buttons to add bridges between your Monitors.

Then resize them to match your physical screen size.

Look at the pictures to get an idea of how it should look.

![Config Screen](https://raw.githubusercontent.com/r-Larch/MouseTrap/master/images/config-screen.jpg)

The blue-reddish bar should cover the space where you want to move your mouse-pointer between your Monitors.

And **it counts the hole size**, from red tip to red tip.

![Bridge](https://raw.githubusercontent.com/r-Larch/MouseTrap/master/images/bridge-pic.jpg)

![Bridge top](https://raw.githubusercontent.com/r-Larch/MouseTrap/master/images/bridge-top-pic.jpg)
![Bridge bottom](https://raw.githubusercontent.com/r-Larch/MouseTrap/master/images/bridge-bottom-pic.jpg)
![Bridge](https://raw.githubusercontent.com/r-Larch/MouseTrap/master/images/bridge-snap.jpg)

You can always test your Settings before saving them.

Exit this configuration screen by hitting your `ESC` key or by hitting the `Close` button.

![Test and save](https://raw.githubusercontent.com/r-Larch/MouseTrap/master/images/test-and-save.jpg)

If you encounter any bugs don't hesitate to open an issue and I will give my best to fix it.