Utility Overview

Automatic X11 Window Placement

A lightweight background utility that ensures newly opened application windows appear exactly where you are looking—on the monitor containing your mouse cursor.

🖱️

Mouse-Aware

Dynamically calculates monitor bounds and centers windows on the active screen based on cursor location.

⚙️

Process Tracking

Monitors PIDs to ensure apps only center on initial launch, preventing jumping during refreshes.

🚫

App Filtering

Supports a blacklist (e.g., Guake) to ignore specific apps that manage their own positioning.

Compatibility Landscape

Understanding where this utility works is critical. Because it relies on explicit window geometry calculations, it is intimately tied to the display server architecture.

Environment Support Distribution

Conceptual representation based on documented limitations.

Supported

Tested primarily on Linux Mint with X11 and systems utilizing Systemd. Standard EWMH-compliant managers are fully compatible.

Not Supported

Wayland environments are strictly unsupported. Wayland's security protocol completely isolates window geometries.

Interactive Requirement Checklist:

Installation Guide

Choose the path that fits your workflow. Ensure dependencies are met before executing the automated script.

1. Install Dependencies

Debian / Ubuntu / Mint
sudo apt update && sudo apt install wmctrl xdotool x11-xserver-utils x11-utils

Execute the provided installation script in the repository root:

chmod +x install.sh
./install.sh

Code Explorer

Review the core logic and systemd configuration directly.

bin/move-center-window.sh