WindowCharmer

WindowCharmer is a three-column window tiler for ultra-wide monitors, designed to be compatible with the Cinnamon desktop environment. It can likely work on any X11 environment, but this has not been tested and may need tweaking.

Installation

git clone git@github.com:BLuFeNiX/windowcharmer.git
cd windowcharmer
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

Usage

Daemon Mode

cd windowcharmer
source .venv/bin/activate
windowcharmer -d

You will likely want to run this automatically on login, which is an exercise left for the user, but start_daemon.sh will work for most users by simply adding that file to your startup programs list.

Note: Removing conflicting keybindings in your desktop environment (such as window snapping controls) should NOT be necessary. They will be overridden while the daemon is running.

Default Keybindings

The activation key is Super_L (the left "Windows" key), and the bindings can currently only be changed from source code:

key_combinations = {
    'Up':           lambda: do_action("max"),           # Up
    'Down':         lambda: do_action("center"),        # Down
    'Left':         lambda: do_action("left"),          # Left
    'Right':        lambda: do_action("right"),         # Right
    'space':        lambda: do_action("restore"),       # spacebar

    'KP_Home':      lambda: do_action("top-left"),      # Numpad 7
    'KP_Up':        lambda: do_action("top-center"),    # Numpad 8
    'KP_Page_Up':   lambda: do_action("top-right"),     # Numpad 9
    'KP_Left':      lambda: do_action("left"),          # Numpad 4
    'KP_Begin':     lambda: do_action("center"),        # Numpad 5
    'KP_Right':     lambda: do_action("right"),         # Numpad 6
    'KP_End':       lambda: do_action("bottom-left"),   # Numpad 1
    'KP_Down':      lambda: do_action("bottom-center"), # Numpad 2
    'KP_Page_Down': lambda: do_action("bottom-right"),  # Numpad 3
    'KP_Insert':    lambda: do_action("restore"),       # Numpad 0

    'KP_Prior':     lambda: do_action("top-right"),     # Numpad 9 (alternate keyboard layout)
    'KP_Next':      lambda: do_action("bottom-right"),  # Numpad 3 (alternate keyboard layout)

    'KP_Add':       lambda: do_action("bigger"),        # Numpad +
    'KP_Subtract':  lambda: do_action("smaller"),       # Numpad -

    'BackSpace':    lambda: sys.exit(),                 # backspace
}

For example, to tile the window to the left, press Super and the left arrow key. To kill the daemon, press Super+backspace.

Scripting

usage: windowcharmer [-h] [-d]
                     [{left,center,right,top-left,bottom-left,top-right,bottom-right,top-center,bottom-center,max,restore,cycle,install,bigger,smaller,test}]

For example, to move the currently focused window to the right side of the screen: windowcharmer right

Support

For issues, questions, or contributions, please refer to the issue tracker.