Skip to content

szymonwilczek/meson

Repository files navigation

Meson Icon

Meson - Center Window Utility

Minimalist utility to instantly center the active window on its current monitor.

License

Overview

Meson is a minimalist GNOME Shell extension designed to do one thing and do it perfectly: center windows.

It calculates the exact center of the current monitor (where the window mostly resides), respecting the system's work area (Top Bar, Dock), and ensures the window title bar is always accessible via safety clamps.

Features

Category Description
Performance No animations, no indicators, no background polling. Zero resource usage when idle.
Smart Logic Calculates center based on the Monitor Work Area, automatically excluding panels and docks.
Safety Safety Clamps ensure window title bars never get pushed off-screen, even for windows taller than the display.

Installation

Method 1: GNOME Extensions

Extension is available here: Meson - Center Window Utility

Method 2: Build from Source

You'll need following dependencies:

  • make
  • zip (for packaging)
# Clone repository
git clone https://github.com/szymonwilczek/meson.git
cd meson

# Build and install
make install

Alternative: Shell Script (No Make required)

If you don't have make installed, you can use the provided script:

./scripts/install.sh

Steps after installation

  1. Restart GNOME Shell (Log out/in on Wayland, Alt+F2 -> r on X11).
  2. Enable the extension:
    gnome-extensions enable meson@szymonwilczek.github.io

Configuration

Settings can be accessed via the Extensions app.

  • Shortcut: Click the row to record a new keybinding (Default: <Super>c).
  • Behavior: The extension works instantly upon keypress.

Contributing

Pull requests are welcome. This project aims to remain minimalist, so feature requests for complex window management (tiling, snapping) might be out of scope.

License

GPL-3.0