Skip to content

KSizer is a KWin script that adds resize presets to the window menu, letting you quickly size and center windows to saved dimensions.

License

Notifications You must be signed in to change notification settings

allenguarnes/KSizer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 

Repository files navigation

KSizer

KSizer is a KWin script that adds resize presets to the window menu, letting you quickly size and center windows to saved dimensions.

Screenshot

KSizer window menu

Features

  • Adds a "KSizer " submenu in the window menu.
  • Resizes windows to preset widths and heights.
  • Centers windows by default (configurable).
  • Presets are configurable from System Settings.

Requirements

  • KDE Plasma with KWin scripting support (Plasma 6 recommended).

Install

  1. Copy the package directory into your KWin scripts folder.
    • Example: ~/.local/share/kwin/scripts/KSizer
  2. In System Settings, open Window Management > KWin Scripts.
  3. Enable the script and click Configure to edit presets.
  4. Click Apply.

Usage

  1. Focus a window.
  2. Open the window menu using Alt+F3 or by right clicking the titlebar.
  3. Open the "KSizer " submenu.
  4. Pick a preset to resize and center the window.

Configuration

  • Presets are stored under the Presets key in the script config.
  • Centering is enabled by default and can be changed in the configuration UI.
  • After changing presets, toggle the script off/on to refresh the menu.

Project Layout

  • package/metadata.json: KWin package metadata.
  • package/contents/code/main.js: main script entrypoint.
  • package/contents/config/main.xml: KConfigXT schema for presets.
  • package/contents/ui/config.ui: configuration UI.

Development

No build, lint, or test tooling is configured.

Manual testing:

  1. Enable or reload the script in System Settings > Window Management > KWin Scripts.
  2. Open any window, press Alt+F3, and select a preset.
  3. Verify the window resizes and centers within the available area.

License

GPL-3.0-or-later. See LICENSE.

Support

If KSizer helps your workflow, you can support development here: https://buymeacoffee.com/allenguarnes

About

KSizer is a KWin script that adds resize presets to the window menu, letting you quickly size and center windows to saved dimensions.

Resources

License

Stars

Watchers

Forks

Packages

No packages published