README.md

A healthy, bite-sized window manager written in C over the XLib library.

Description

berry is a floating window manager that responds to X events and manages window decorations.

berryc is a small client that sends X events to manage windows and configuration settings.

Much like bspwm and windowchef, berry does not handle keyboard inputs. Instead, a program like sxhkd is needed to translate input events to berryc commands.

Installation

First, install the XLib C headers on your distribution. On Ubuntu/Debian, for example, they are available as libx11-dev

Clone the repository and make it

git clone https://github.com/JLErvin/berry
cd berry
make
sudo make install

Copy the sample configuration files

mkdir $HOME/.config/berry
cp berry/examples/sxhkdrc $HOME/.config/berry/sxhkdrc
cp berry examples/autostart $HOME/.config/berry/autostart

Add the following to your .xinitrc

sxhdrc -c $HOME/.config/berry/sxhkdrc &
exec berry

Arch Linux users can download via the AUR: berry

yay -S berry

Usage

berry relies on a program like sxhkd to handle keypress events. You can use man berryc to view available commands and bind them to your favorite keystrokes in sxhkdrc.

Features

• Multiple desktops
• Keyboard-drive resizing and movement
• Command line client to control windows and decorations
• Double borders
• Title bars
• Left/right snapping
• Fullscreen/monocle mode

TODO

• Add pointer move/resize support
• Titlebar window text
• Add more EWMH/ICCCM protocols

Credits

Although I wrote berry on my own, it was inspired by people much smarter than I. A very special thanks to the following people for writing great code and open-sourcing it!

• Tudurom's windowchef
• Vain's katriawm

Contributors

Special thanks to the following people for contributing:

• Kyle G: AUR Package Maintainer

Additional Screenshots

Double borders with titlebars:

Monocle Mode