https://github.com/lycuid/cluless
A fantasy motivated, customizable, dynamic tiling window manager.
https://github.com/lycuid/cluless
cluless window-manager x11 xorg
Last synced: about 1 year ago
JSON representation
A fantasy motivated, customizable, dynamic tiling window manager.
- Host: GitHub
- URL: https://github.com/lycuid/cluless
- Owner: lycuid
- License: gpl-3.0
- Created: 2022-07-03T15:53:55.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2024-09-07T12:51:28.000Z (almost 2 years ago)
- Last Synced: 2024-09-08T01:34:46.146Z (almost 2 years ago)
- Topics: cluless, window-manager, x11, xorg
- Language: C
- Homepage:
- Size: 765 KB
- Stars: 6
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# cluless
**cluless** is a fantasy motivated, _(mildly opinionated)_ and customizable dynamic tiling [window manager](https://wiki.archlinux.org/title/window_manager). The development was motivated by the author's fantasy of having the feeling of being inside the [grid](https://tron.fandom.com/wiki/Grid), while using his computer. The design and structure was motivated by the author's previously, daily driven, window managers: [xmonad](https://xmonad.org) and [dwm](https://dwm.suckless.org).
- Statusbar: clubar <[https://github.com/lycuid/clubar](https://github.com/lycuid/clubar)>
- Terminal: Simple Terminal <[https://st.suckless.org/](https://st.suckless.org/)>
Layouts
-------
|Tall (master/stack) | Full (fullscreen) |
|--------------------|-------------------|
| |  |
Requirements
------------
- ***free***, ***libre*** and ***open source*** Operating System (currently doesn't support \*BSD).
- gnu make
- libx11
- pkg-config (optional, changes would be required in Makefile)
Build and Install
-----------------
```sh
make && sudo make install
```
Usage
-----
put the following line in the `~/.xinitrc` file, and use any preferred method (e.g [startx](https://man.archlinux.org/man/startx.1), [xinit](https://man.archlinux.org/man/xinit.1)) to execute it.
```sh
exec cluless
```
Status logs for statusbar ([clubar](https://github.com/lycuid/clubar), in this case) are dumped to `stdout`, which can be redirected in any way suitable.
```sh
exec cluless | clubar
```
using fifo.
```sh
STATUS=/tmp/statusbar${DISPLAY}
[ ! -p ${STATUS} ] && mkfifo ${STATUS}
clubar <${STATUS} &
exec cluless >${STATUS}
```
using a fifo might be slower compared to other methods, but also can be very convenient as the statusbar program will run independent of the window manager (i.e statusbar can be killed, restarted etc. without killing the window manager process).
Features
--------
- ***scratchpads***: togglable windows.
- ***window rule***: hooks for newly created windows (make window floating, or move to different workspace etc).
- ***companions***: window follows the user across workspaces. (best used with floating windows, as it might mess up the tiling).
- ***magnify***: magnify focused window (useful in case of many tiled windows).
License:
--------
[GPLv3](https://gnu.org/licenses/gpl.html)