CatWM - A continued version of LarsWM

IMPORTANT NOTE

For licensing notes, look at README.original

What is this?

CatWM is a continued version of LarsWM, a tiling window manager. It works well with polybar and picom. (To make this somewhat usable, use picom. It adds rounded corners.) A picom and polybar config is included in examples/

How to install this?

This program requires...

• GNU Make and GCC
• libx11, libxext and libxmu

On debian and derviates, installation is as simple as:

sudo apt install libx11-dev \
libxext-dev libxmu-dev make gcc

After installing the dependencies, compile the program with make:

make all

To install base binaries, use this:

make install

To install additional scripts, a picom configuration at /etc/picom.conf and display manager desktop files, use this:

make install_additional

To not install to /usr/bin but somewhere else, you can specify the INSTALL_PREFIX variable:

INSTALL_PREFIX=/tmp/ make install

Documentation for additional scripts

To run programs at startup, you can create a larsautorc file...:

• ...either as ~/.larsautorc
• ...or as /usr/share/larsautorc. For a reference script, look at examples/sample.larsautorc. This larsautorc example also holds information on how to properly use picom with larswm. To launch this file, you need to run runlarswm instead of the larswm binary. If you use a display manager, just select the CatWM with additional applications entry instead of the CatWM one, otherwise run runlarswm. For further documentation such as keyboard bindings, look at README.original.

Screenshot of configured instance:

screenshot