# cpywm
### cpywm - CPython powered window manager

cpywm is CPython powered tiling window manager for x11.
It's entirely configured with Python and uses CPython pure embedding.

Running cpywm will expose a `cpywm` module in Python which
can be used by Python code to create configurations that the
window manager will then subsequently use.

## Requirements

 - CPython 3.7
 - Xlib header files

## Installation

 - `git clone https://github.com/mental32/cpywm`
 - `cd cpywm`
 - `sudo make install`

## Running cpywm

Add the following line to your `.xinitrc` to start cpywm using startx:

 - `exec cpywm`

In order to connect cpywm to a specific display, make sure that the `DISPLAY` environment variable is set correctly, e.g.:

 - `DISPLAY=foo.bar:1 exec cpywm`

This will start dwm on display `:1` of the host `foo.bar`.

## Configuration

The configuration of cpywm is done by creating a custom Python package and supplying cpywm an import path or a file path.

 - `exec cpywm ~/.config/cpywm/config.py`

If no config was supplied cpywm will use the (default configuration)[./default.py]