path: root/README.md

# Emacs X Window Manager

EXWM (Emacs X Window Manager) is a full-featured tiling X window manager
for Emacs built on top of [XELB](https://github.com/ch11ng/xelb).
It features:
+ Fully keyboard-driven operations
+ Hybrid layout modes (tiling & stacking)
+ Dynamic workspace support
+ ICCCM/EWMH compliance
+ (Optional) RandR (multi-monitor) support
+ (Optional) Built-in composting manager
+ (Optional) Built-in system tray

Please check out the
[screenshots](https://github.com/ch11ng/exwm/wiki/Screenshots)
to get an overview of what EXWM is capable of,
and the [user guide](https://github.com/ch11ng/exwm/wiki)
for a detailed explanation of its usage.

**Note**: If you install EXWM from source, it's recommended to install
XELB also from source (otherwise install both from GNU ELPA).