ContextQMD
Back to Littlebigmouse

Little Big Mouse

README.md

5.5.16.3 KB
Original Source

Little Big Mouse

<p align="center"> </p>

[!IMPORTANT]

🎉 5.5.0 is out!

The UI and the mouse daemon now talk over a secure per-user local channel instead of a TCP port (#519): no more port clashes, a killed daemon restarts instantly, and the startup configuration survives crashes with automatic backup recovery. Clicks and wheel scrolls during a screen crossing now land where you expect, and excluding an elevated (anti-cheat) game actually pauses the hook (#518). The monitor control panel gets an opt-in live read to follow OSD changes, plus safer display topology and clone-mode handling (#517).

⬇ Download 5.5.0 — requires the .NET 10 Runtime (x64).

Something not working? Tell us 🙏

Little Big Mouse (LBM) is an open-source software designed to enhance the multi-monitor experience on Windows 10 and 11 by providing accurate mouse screen crossover location within multi-DPI monitors environments. This is particularly useful for setups involving a 4K monitor alongside a full HD monitor.

Donations

If you find Little Big Mouse helpful, consider supporting the project with a donation. Your contribution helps us maintain and improve the software.

Presentation Video

Check the very nice video from Touble Chute (a very big thanks to him):

Features

  • Smooth Mouse Transitions: Ensures smooth and accurate mouse movement across screens with different DPI settings.
  • DPI Aware Mouse Movement: Adjusts mouse speed to remain consistent across monitors with different DPI values.
  • Infinite Mouse Scrolling: Enables seamless cursor movement between screens, either horizontally or vertically.
  • Display Size Adjustments: Allows for adjustments in the relative sizes of displays.
  • Border Resistance: Allow some resistance before crossing.
  • Display Color and Brightness Balancing: Offers control over color and brightness profiles of displays.
  • Access to Display Debugging Information: Provides detailed information from your displays and drivers.

Installation

  1. Download the latest release from the Releases page.
  2. Run the Little Big Mouse installer from your computer.
  3. (Optional) Change the default installation path.
  4. Follow the installation progress and complete the installation.
  5. Access the program from the Start Menu.

Linux (experimental)

The Linux port works, but is still experimental and currently builds from source only. Mouse routing uses an evdev/uinput backend — it grabs the physical mice and drives a virtual pointer, exactly like the Windows hook — with Wayland-portal and X11 fallbacks. It is developed and tested on KDE Plasma 6 (Wayland); feedback from other desktops is very welcome on the issues page.

Prerequisites

  • The .NET 10 SDK (the runtime alone is not enough to build) and the Rust toolchain (cargo):
    • Arch / CachyOS: sudo pacman -S dotnet-sdk rust
    • other distros: .NET SDK and rustup
  • Access to /dev/input and /dev/uinput for the evdev backend: add yourself to the input group (sudo usermod -aG input $USER), then log out and back in — without it the daemon silently falls back to the portal/X11 backend.

Build and run

bash
git clone --recursive https://github.com/mgth/LittleBigMouse.git
cd LittleBigMouse
./run-lbm.sh

run-lbm.sh builds the hook daemon (cargo) and the UI (dotnet), stages everything and relaunches the app. UI and daemon logs land in /tmp/lbm-ui.log. If you cloned without --recursive, run git submodule update --init --recursive first — the HLab projects are submodules.

Usage

Documentation : https://github.com/mgth/LittleBigMouse/wiki

Little Big Mouse provides a single-window interface with three main sections:

  • Top Panel: Access view tabs for display and display adapter information, changing relative sizes and positions of displays, and adjusting color and brightness profiles.
  • Center Panel: Displays information about your display devices, including makes and models, capabilities, adapters, and relative positions.
  • Bottom Panel: Offers options and operations, including copying config to clipboard, enabling/disabling LBM functionality, and adjusting speed, pointer size, and corner crossing.

Support

If you encounter any issues or have suggestions for improvements, please open an issue on our Issues page. We appreciate your feedback and are always looking to improve the tool.

We Welcome Contributions: Your help is invaluable! Whether it's reporting bugs, suggesting new features, or submitting pull requests, we encourage you to get involved. Your contributions can make a significant difference in the development and improvement of Little Big Mouse. First time? Check out This guide to get started.

Acknowledgements

Thank you for using Little Big Mouse!