winget install --id=LGUG2Z.masir -e
Focus Follows Mouse for Windows
masir is a focus-follows-mouse utility designed to enable window focusing by simply moving your mouse over application windows on Windows 11 and later. This tool enhances productivity by eliminating the need for clicks or taps to interact with windows.
Key Features:
Audience & Benefit:
Ideal for users seeking efficient window management on Windows, particularly those using tiling window managers like komorebi. masir improves productivity by enabling a more intuitive and distraction-free workflow, allowing users to focus on their tasks with minimal interruptions.
masir can be installed via winget, ensuring easy setup and integration into your system.
Focus Follows Mouse for Windows.
masir is a focus follows mouse daemon for Microsoft Windows 11 and above.
masir allows you to focus an application window by moving your mouse over it, without requiring mouse clicks or touchpad taps.
masir does not have a dependency on any specific external software or tiling window manager.
masir has an additional integration with komorebi to ensure that only windows managed by the tiling window manager are eligible to be focused. Integrations with other tiling window managers are welcome ("Integrations".)
masir is a free and educational source project, and one that encourages you to make charitable donations if you find the software to be useful and have the financial means.
I encourage you to make a charitable donation to the Palestine Children's Relief Fund or contributing to a Gaza Funds campaign before you consider sponsoring me on GitHub.
GitHub Sponsors is enabled for this project. Unfortunately I don't have anything specific to offer besides my gratitude and shout outs at the end of komorebi live development videos and tutorials.
If you would like to tip or sponsor the project but are unable to use GitHub Sponsors, you may also sponsor through Ko-fi.
winget install LGUG2Z.masir
masir
can be run as a standalone process, or launched alongside komorebi
using the komorebic start
command with the --masir
flag.
If you would like to contribute to masir
please take the time to carefully read the guidelines below.
use
statementscargo +stable clippy
and ensure that all lints and suggestions have been addressed before committingcargo +nightly fmt --all
to ensure consistent formatting before committinggit cz
with
the Commitizen CLI to prepare
commit messagesmasir
is licensed under the Komorebi 2.0.0 license, which
is a fork of the PolyForm Strict 1.0.0
license. On a high level
this means that you are free to do whatever you want with masir
for
personal use other than redistribution, or distribution of new works (i.e.
hard-forks) based on the software.
Anyone is free to make their own fork of masir
with changes intended
either for personal use or for integration back upstream via pull requests.
The Komorebi 2.0.0 License does not permit any kind of commercial use.
Contributions are accepted with the following understanding:
By making a contribution, you accept both the current project license terms, and that all contributions that you have made are provided under the terms of the 0-BSD license.
Permission to use, copy, modify, and/or distribute this software for
any purpose with or without fee is hereby granted.
THE SOFTWARE IS PROVIDED “AS IS” AND THE AUTHOR DISCLAIMS ALL
WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES
OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE
FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY
DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
If you would like to create an integration between masir and a tiling window manager, there is only one requirement:
The path to this file of HWNDs can be passed with the --hwnds
flag for testing purposes.
masir will check for the presence of the HWND under the mouse cursor in this file when deciding if the window is eligible to be focused.
Once testing is complete, native support for checking this file without requiring the --hwnds
argument can be added
directly to masir
(see TODO: We can add checks for other window managers here
in main.rs
).