Skip to content

davidosomething/yanjing

Repository files navigation

Yanjing

KWin script to resize and move windows. Like Spectacle/Rectangle on mac.

Installation

Available in the KDE store for

Configuration

You can customize the sizes this script cycles through by setting them in your kwin config using this command:

kwriteconfig5 --file kwinrc --group Script-yanjing --key sizes "50,66,34,100"
qdbus org.kde.KWin /KWin reconfigure

This will write the sizes to your ~/.config/kwinrc file under the [Script-yanjing] group. You may need to disable and re-enable the plugin in System Settings > KWin Scripts for the sizes to be read.

Commands

You can customize the shortcuts in

System Settings > Input & Output - Keyboard > Shortcuts > KWin

Defaults:

  • Yanjing LEFT - no default
    • Vertically maximize, flush the window to the LEFT side of the screen, or resize width if already flushed.
  • Yanjing CENTER - no default
    • Vertically maximize, center window horizontally, or resize width if already centered. Centering allows a 2px margin of error.
  • Yanjing RIGHT - no default
    • Vertically maximize, flush the window to the RIGHT side of the screen, or resize width if already flushed.
  • Yanjing yMax + LEFT - Meta+Ctrl+Shift+a
    • Vertically maximize, flush the window to the LEFT side of the screen, or resize width if already flushed.
  • Yanjing yMax + CENTER - Meta+Ctrl+Shift+x -
    • Vertically maximize, center window horizontally, or resize width if already centered. Centering allows a 2px margin of error.
  • Yanjing yMax + RIGHT - Meta+Ctrl+Shift-D
    • Vertically maximize, flush the window to the RIGHT side of the screen, or resize width if already flushed.

Resizing logic

The window will steps through the Sizes array. It does so in reverse order, so as you "shove" the window against each edge of the screen or into the center more, it shrinks. It will loop back to the largest size.

License

MIT