Focus Toggler

A lightweight Windows utility that toggles Focus Follows Mouse (X-Mouse / Active Window Tracking) with a single click — no digging through Control Panel required.

Why

Windows buries the "hover to focus" setting deep in Control Panel. This utility puts a one-click shortcut on your desktop, and the icon updates to show the current state at a glance.

Features

• Instant toggle — applies the change immediately, no reboot needed
• Dynamic icon — shortcut icon switches between on.ico and off.ico
• Silent execution — runs via pythonw.exe with no console window

Requirements

• Windows 10 or 11
• Python 3.8+

Installation

1. Clone the repository:

   git clone https://github.com/grenkoff/focus-toggler.git
   cd focus-toggler

2. Create a virtual environment and install dependencies:

   python -m venv .venv
   .venv\Scripts\activate
   pip install -r requirements.txt

How to Use

1. Run the script once to create the desktop shortcut:

   python main.py

2. A shortcut named FocusToggler will appear on your Desktop.

3. Double-click it anytime to toggle the mode. The icon updates automatically.

Project Structure

focus-toggler/
├── assets/
│   ├── on.ico
│   └── off.ico
├── main.py
├── requirements.txt
├── CHANGELOG.md
├── LICENSE
└── README.md

License

This project is licensed under the MIT License. See the LICENSE file for details.