https://github.com/apes0/zelo
A window manager i made!
https://github.com/apes0/zelo
wm x11 x11-wm xcb
Last synced: 15 days ago
JSON representation
A window manager i made!
- Host: GitHub
- URL: https://github.com/apes0/zelo
- Owner: apes0
- License: gpl-3.0
- Created: 2023-07-28T13:00:20.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-07-08T23:38:14.000Z (6 months ago)
- Last Synced: 2025-07-09T00:39:13.712Z (6 months ago)
- Topics: wm, x11, x11-wm, xcb
- Language: Python
- Homepage:
- Size: 3.87 MB
- Stars: 6
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](./extensions/readme.md) for a guide on configuring extensions and what they do
- [utils/readme.md](./utils/readme.md) for the usage of the utility functions
- [extensions/widgets/readme.md](./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
