Zelo

This is an X11 window manager written in python.

Installation

Debian or Ubuntu

There is currently an install script, located in scripts/setup.sh, but it works only on Debian and Ubuntu (i have tested it on both).

Anything else

If you are running anything unsupported by the install script, you need to do the following:

• dowload the following dependencies: libxcb-util-dev libx11-xcb-dev libxcb-keysyms1-dev libxcb-image0-dev libxcb-randr0-dev python3

• run pip3 install -r requirements.py or install the following modules from your package manager: python3-cffi python3-opencv python3-trio

• run ./scripts/keysyms.sh

Tip

(Optionally) run sudo ./scripts/Xsession.sh to add the window manager to your xsession directory and also add it to /bin

Updating

To update, run ./scripts/update.sh. It will keep all the changes you have applied.

Configuring

The configuration is held in cfg.py, there you can put shortcuts, extensions and their config, and what to be run when the window manager starts. I might add more info about how to configure the window manager.

Currently, the following docs are available:

• extensions/readme.md for a guide on configuring extensions and what they do
• utils/readme.md for the usage of the utility functions
• extensions/widgets/readme.md for the usage of widgets

Bugs

This is a section dedicated to bugs that i know of and will think about solving.

• qt apps do not work, unless you delete ~/.local/lib/python3.10/site-packages/cv2/qt/plugins/platforms/libqxcb.so (not sure if it's just on my system)
• apps that cannot be resized are kinda jank and dont really work well
• mouse themeing doesn't work for some reason
• right clicking sometimes doesn't work

Images