{"repo":"sminez/penrose","free":true,"listed":false,"github":"https://github.com/sminez/penrose","clone":"git clone https://github.com/sminez/penrose.git","description":"A library for writing an X11 tiling window manager","language":"Rust","stars":1351,"topics":["window","manager","wm","x11","x11-wm","xcb","rust","xcb-api"],"license":"MIT","category":"dev-tools","readme_excerpt":"penrose - a tiling window manager library ========================================= Penrose is a modular library for configuring your own X11 window manager in Rust. This means that, unlike most other tiling window managers, Penrose is not a binary that you install on your system. Instead, you use it like a normal dependency in your own crate for writing your own window manager. Don't worry, the top level API is well documented and a lot of things will work out of the box, and if you fancy digging deeper you'll find lots of opportunities to customise things to your liking. tl;dr - getting started The user facing docs for penrose are written using mdBook and published to GitHub Pages [here][0]. They cover some more general concepts about how to get up and running as opposed to the [crate docs][1] on docs.rs which are more aimed at covering the APIs themselves and are what you would expect from an open source library. The current version of the docs build from the head of the develop branch can be found [here][2]. If you want to have a look at how it all comes together then the [examples][3] directory of this repo has several different starting points for you to begin with and my personal set up can be found [here][4]. (You almost certainly don't want to use my set up in full but it should serve as a good reference for what a real use case looks like!) Penrose from scratch The penrose from scratch repo is an example window manager written using penrose that was developed as par","default_branch":null,"files":null,"tree":[],"storefront":"/r/sminez","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/sminez/penrose/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}