Skip to content

sminez/penrose-from-scratch

Repository files navigation

Let's write a window manager from scratch

Writing an X11 window manager from scratch using penrose.

You can follow along with the development of this repo on youtube.

This is a work in progress project to build up a fully featured tiling window manager from scratch so please make sure you have an alternative desktop environment available to use in case anything breaks!

Installation

NOTE: Really do read the Makefile before installing: there's nothing harmful in there but you should always know what you are running under sudo!

Make sure you have Rust installed on your system and take a look at the default key bindings in main.rs, you will want to swap out st and dmenu_run for a terminal and program launcher you have installed if you're not using them.

With that done, read the contents of the Makefile in the root of the repo before running the following in a terminal to build and install the window manager:

$ make build && sudo make install

This should set you up for running penrose-from-scratch as a desktop session from your display manager when you log in.

Following along

The progress-so-far.md file in the root of this repository acts as a bit of a change log and reference for what we've done so far. If you're looking for a summary of what's been implemented (and when it was implemented) that's a good place to start.