krohnkite/README.md

3.7 KiB

Kröhnkite

A dynamic tiling extension for KWin.

Kröhnkite is mainly inspired by dwm from suckless folks, and aims to be "simple" in both development and usage.

screenshot

Build & Install

You can install Kröhnkite in multiple ways.

The simplest method would be:

make install

This will automatically build and install kwinscript package. Note that you can manually build package file using make package. The generated package file can be imported from "KWin Script" dialog in "System Settings".

If you don't want to install the script, but still want to try, you can:

make run
make stop

to temporarily load (and unload) the script to KWin. You may also want to restart KWin w/:

kwin_x11 --replace

New instance will replace the current one, and print debugging message(i.e. console.log) to terminal. This is useful for testing and debugging.

Default Key Bindings

Key Action
Meta + J Focus Down/Next
Meta + K Focus Up/Previous
Meta + H Left
Meta + L Right
Meta + Shift + J Move Down/Next
Meta + Shift + K Move Up/Previous
Meta + Shift + H Move Left
Meta + Shift + L Move Right
Meta + I Increase
Meta + D Decrease
Meta + F Toggle Floating
Meta + \ Cycle Layout

Tips

Removing Title Bars

  1. System Setting > Application Style > Window Decorations
  2. Click Configure Breeze inside the preview.
  3. Window-Specific Overrides tab > Add button
  4. Enter the following:
    • Regular expression to match: .*
    • Check Hide window titel bar

(Note: not all decorations support this feature.)

Changing Border Colors

Changing the color of borders makes it easier to identify the currently focused window. This is quite an essential if title bars are removed.

  1. Open ~/.config/kdeglobals with your favoir editors. (i.e. Kate, Vim, Nano)
  2. Scroll down and find [WM] section
  3. Below the section, append the followings:
    • frame=61,174,233: set the border color of active window to RGB(61,174,233)
    • inactiveFrame=239,240,241: set the border color of inactive window to RGB(239,240,241)
  4. You must restart your session to see changes. (i.e. re-login, reboot)

(Note: the RGB values presented here is for the default Breeze theme. Feel free to change these values. You can use KColorChooser to pick colors from the screen.)

Useful Development Resources