WindowFollower

English | 中文

English

WindowFollower is a lightweight, event-driven Windows utility for multi-monitor setups. It detects application child windows that open on the wrong monitor and moves them to the monitor containing the application's main window.

Features

• Event-driven, low-latency window handling
• Low idle CPU usage
• Supports Windows 10 and Windows 11
• Optional autostart at Windows sign-in
• No registry or monitor-setting changes
• No third-party dependencies
• No logs, status files, or temporary files created at runtime

Installation

1. Download or clone the complete project.
2. Keep the complete WindowFollower folder in a permanent location.
3. Double-click Install-WindowFollower-Autostart-Admin.bat.
4. Approve the Windows administrator prompt.

The tool starts immediately and will start automatically at future Windows sign-ins. The installer normally needs to be run only once.

Controls

• Start manually: Start-WindowFollower.bat
• Stop the current session: Stop-WindowFollower.bat
• Disable autostart: Disable-WindowFollower-Autostart.bat

Important Folder Rules

Do not delete the tool folder after installation. The autostart task runs WindowFollower.ps1 directly from this folder.

If the folder is moved or renamed:

1. Run Stop-WindowFollower.bat.
2. Move or rename the complete folder.
3. Run Install-WindowFollower-Autostart-Admin.bat from the new location.

To remove WindowFollower completely, stop it, disable autostart, and then delete the complete folder.

Documentation

• Chinese: WindowFollower-使用说明.txt
• English: WindowFollower-User-Guide.txt

Security

WindowFollower requires administrator permission so that it can manage windows belonging to elevated applications. The project does not download software, access the network, or collect user data. Review the PowerShell and batch files before use.

License

Released under the MIT License. See LICENSE.

---

中文说明

WindowFollower 是一个适用于 Windows 多显示器环境的轻量工具。当应用程序的子窗口、对话框或设置窗口出现在错误显示器时，它会尝试将窗口移动到该应用程序主窗口所在的显示器。

主要特点

• 事件触发，窗口响应延迟低
• 空闲时资源占用低
• 支持 Windows 10 和 Windows 11
• 支持登录 Windows 后自动启动
• 不修改注册表和显示器设置
• 不需要第三方软件
• 运行时不生成日志、状态或临时文件

安装

1. 下载或克隆整个项目。
2. 将完整的 WindowFollower 文件夹放在长期保留的位置。
3. 双击 Install-WindowFollower-Autostart-Admin.bat。
4. Windows 弹出管理员确认时选择“是”。

工具会立即启动，并在以后每次登录 Windows 时自动运行。安装入口通常只需运行一次，不需要每次开机后重复运行。

日常操作

• 手动启动：Start-WindowFollower.bat
• 停止当前运行：Stop-WindowFollower.bat
• 取消开机自启：Disable-WindowFollower-Autostart.bat

文件夹注意事项

安装后不要删除工具文件夹。开机任务会直接运行文件夹中的 WindowFollower.ps1，删除工具包会导致开机自启失效。

移动或重命名文件夹时：

1. 运行 Stop-WindowFollower.bat。
2. 移动或重命名完整文件夹。
3. 在新位置重新运行 Install-WindowFollower-Autostart-Admin.bat。

如果需要彻底删除工具，请先停止当前运行，再取消开机自启，最后删除整个文件夹。

文档

• 中文：WindowFollower-使用说明.txt
• English：WindowFollower-User-Guide.txt

安全说明

WindowFollower 需要管理员权限，以便处理由管理员权限运行的应用程序窗口。项目不会下载软件、访问网络或收集用户数据。建议使用前查看项目中的 PowerShell 和批处理文件。

许可证

本项目使用 MIT License，详见 LICENSE。