{"id":27647424,"url":"https://github.com/lgug2z/masir","last_synced_at":"2025-04-24T01:49:45.909Z","repository":{"id":265792714,"uuid":"896648335","full_name":"LGUG2Z/masir","owner":"LGUG2Z","description":"Focus Follows Mouse for Windows","archived":false,"fork":false,"pushed_at":"2025-04-22T00:17:37.000Z","size":124,"stargazers_count":36,"open_issues_count":3,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-24T01:49:41.879Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LGUG2Z.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"LGUG2Z","ko_fi":"lgug2z"}},"created_at":"2024-11-30T23:26:24.000Z","updated_at":"2025-04-22T00:16:38.000Z","dependencies_parsed_at":"2025-02-25T01:24:27.437Z","dependency_job_id":"bd91121a-37f1-4f4b-af0e-8a40e5904af5","html_url":"https://github.com/LGUG2Z/masir","commit_stats":null,"previous_names":["lgug2z/masir"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LGUG2Z%2Fmasir","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LGUG2Z%2Fmasir/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LGUG2Z%2Fmasir/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LGUG2Z%2Fmasir/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LGUG2Z","download_url":"https://codeload.github.com/LGUG2Z/masir/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250546017,"owners_count":21448256,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-04-24T01:49:45.316Z","updated_at":"2025-04-24T01:49:45.902Z","avatar_url":"https://github.com/LGUG2Z.png","language":"Rust","funding_links":["https://github.com/sponsors/LGUG2Z","https://ko-fi.com/lgug2z"],"categories":[],"sub_categories":[],"readme":"# masir\n\nFocus Follows Mouse for Windows.\n\n\u003cp\u003e\n  \u003ca href=\"https://techforpalestine.org/learn-more\"\u003e\n    \u003cimg alt=\"Tech for Palestine\" src=\"https://badge.techforpalestine.org/default\"\u003e\n  \u003c/a\u003e\n  \u003cimg alt=\"GitHub Workflow Status\" src=\"https://img.shields.io/github/actions/workflow/status/LGUG2Z/masir/.github/workflows/windows.yaml\"\u003e\n  \u003cimg alt=\"GitHub all releases\" src=\"https://img.shields.io/github/downloads/LGUG2Z/masir/total\"\u003e\n  \u003cimg alt=\"GitHub commits since latest release (by date) for a branch\" src=\"https://img.shields.io/github/commits-since/LGUG2Z/masir/latest\"\u003e\n  \u003ca href=\"https://discord.gg/mGkn66PHkx\"\u003e\n    \u003cimg alt=\"Discord\" src=\"https://img.shields.io/discord/898554690126630914\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/sponsors/LGUG2Z\"\u003e\n    \u003cimg alt=\"GitHub Sponsors\" src=\"https://img.shields.io/github/sponsors/LGUG2Z\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://ko-fi.com/lgug2z\"\u003e\n    \u003cimg alt=\"Ko-fi\" src=\"https://img.shields.io/badge/kofi-tip-green\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://notado.app/feeds/jado/software-development\"\u003e\n    \u003cimg alt=\"Notado Feed\" src=\"https://img.shields.io/badge/Notado-Subscribe-informational\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://www.youtube.com/channel/UCeai3-do-9O4MNy9_xjO6mg?sub_confirmation=1\"\u003e\n    \u003cimg alt=\"YouTube\" src=\"https://img.shields.io/youtube/channel/subscribers/UCeai3-do-9O4MNy9_xjO6mg\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n_masir_ is a focus follows mouse daemon for Microsoft Windows 11 and above.\n\n_masir_ allows you to focus an application window by moving your mouse over it, without requiring mouse clicks or\ntouchpad taps.\n\n_masir_ does not have a dependency on any specific external software or tiling window manager.\n\n_masir_ has an additional integration with [komorebi](https://github.com/LGUG2Z/komorebi) to ensure that only windows\nmanaged by the tiling window manager are eligible to be focused. Integrations with other tiling window managers are\nwelcome ([\"Integrations\"](#integrations).)\n\n_masir_ is a free and educational source project, and one that encourages you to make charitable donations if you find\nthe software to be useful and have the financial means.\n\nI encourage you to make a charitable donation to\nthe [Palestine Children's Relief Fund](https://pcrf1.app.neoncrm.com/forms/gaza-recovery) or contributing to\na [Gaza Funds campaign](https://gazafunds.com) before you consider sponsoring me on GitHub.\n\n[GitHub Sponsors is enabled for this project](https://github.com/sponsors/LGUG2Z). Unfortunately I don't have anything\nspecific to offer besides my gratitude and shout outs at the end of _komorebi_ live development videos and tutorials.\n\nIf you would like to tip or sponsor the project but are unable to use GitHub Sponsors, you may also sponsor\nthrough [Ko-fi](https://ko-fi.com/lgug2z).\n\n# Installation\n\nWhile package submissions to `scoop` and `winget` are pending, you can install `masir` using `cargo`:\n\n```shell\ncargo install --git https://github.com/LGUG2Z/masir\n```\n\n# Contribution Guidelines\n\nIf you would like to contribute to `masir` please take the time to carefully read the guidelines below.\n\n## Commit hygiene\n\n- Flatten all `use` statements\n- Run `cargo +stable clippy` and ensure that all lints and suggestions have been addressed before committing\n- Run `cargo +nightly fmt --all` to ensure consistent formatting before committing\n- Use `git cz` with\n  the [Commitizen CLI](https://github.com/commitizen/cz-cli#conventional-commit-messages-as-a-global-utility) to prepare\n  commit messages\n- Provide **at least** one short sentence or paragraph in your commit message body to describe your thought process for the\n  changes being committed\n\n## License\n\n`masir` is licensed under the [Komorebi 2.0.0 license](./LICENSE.md), which\nis a fork of the [PolyForm Strict 1.0.0\nlicense](https://polyformproject.org/licenses/strict/1.0.0). On a high level\nthis means that you are free to do whatever you want with `masir` for\npersonal use other than redistribution, or distribution of new works (i.e.\nhard-forks) based on the software.\n\nAnyone is free to make their own fork of `masir` with changes intended\neither for personal use or for integration back upstream via pull requests.\n\nThe [Komorebi 2.0.0 License](./LICENSE.md) does not permit any kind of\ncommercial use.\n\n### Contribution licensing\n\nContributions are accepted with the following understanding:\n\n- Contributed content is licensed under the terms of the 0-BSD license\n- Contributors accept the terms of the project license at the time of contribution\n\nBy making a contribution, you accept both the current project license terms, and that all contributions that you have\nmade are provided under the terms of the 0-BSD license.\n\n#### Zero-Clause BSD\n\n```\nPermission to use, copy, modify, and/or distribute this software for\nany purpose with or without fee is hereby granted.\n\nTHE SOFTWARE IS PROVIDED “AS IS” AND THE AUTHOR DISCLAIMS ALL\nWARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES\nOF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE\nFOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY\nDAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN\nAN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT\nOF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.\n```\n\n# Integrations\n\nIf you would like to create an integration between _masir_ and a tiling window manager, there is only one requirement:\n\n- An updated list of window HWNDs known to and managed by the tiling window manager written to a file in a known\n  location.\n\nThe path to this file of HWNDs can be passed with the `--hwnds` flag for testing purposes.\n\n_masir_ will check for the presence of the HWND under the mouse cursor in this file when deciding if the window is\neligible to be focused.\n\nOnce testing is complete, native support for checking this file without requiring the `--hwnds` argument can be added\ndirectly to `masir` (see `TODO: We can add checks for other window managers here`\nin [`main.rs`](https://github.com/LGUG2Z/masir/blob/a35754a4a29538323bf248b4491f726e366f68bd/src/main.rs#L53)).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flgug2z%2Fmasir","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flgug2z%2Fmasir","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flgug2z%2Fmasir/lists"}