2026-07-03 00:43:34 -04:00
2026-06-28 17:26:07 -04:00
2026-07-03 02:34:29 -04:00
2026-07-03 02:34:29 -04:00
2026-07-03 02:34:29 -04:00
2026-07-03 00:07:45 -04:00
2026-07-03 00:07:45 -04:00
2026-07-03 02:34:29 -04:00
2026-07-02 01:24:16 -04:00
2026-06-30 02:07:19 -04:00
2026-07-02 02:25:06 -04:00
2026-07-02 23:03:28 -04:00

PeachWM

peachwm

peachwm is a fork of swindle PeachWM is now a independent wayland compositor based on WLRoots that is designed to be similar to MangoWC, while remaining lightweight.

PeachWM is maintained by HuntedByTheIRS.

Features

  • Lua configuration
  • Dwindle, Master, Monocle, and Floating layouts
  • XWayland support
  • Lightweight

Dependencies

  • libinput
  • wayland
  • wlroots-0.20 (compiled with the libinput backend)
  • scenefx (for rendering effects)
  • xkbcommon
  • wayland-protocols (compile-time only)
  • pkg-config (compile-time only)
  • a C23 compiler — GCC 14+ or Clang 18+ (clang recommended)

Install these (and their -devel versions if your distro has separate development packages) and run make followed by doas/sudo make install, if you wish to install it (installs to /usr/local/bin/ by default).

SceneFX

PeachWM uses scenefx for rendering eye-candy effects on screen. These effects are now considered stable and no longer experimental.

Effects

  • Rounded corners — smooth, configurable corner rounding on windows
  • Shadows — drop shadows for windows
  • More effects are planned and on the way.

Configuration

Read example/config.lua. It should give you a basic idea of how configuring peachwm works.

Its good to move/copy /etc/peachwm/config.lua to $HOME/.config/peachwm/, but will start without this step if you choose not to.

Installation

make release -j$(nproc)
sudo make install
mkdir -p $HOME/.config/peachwm/
cp /etc/peachwm/config.lua $HOME/.config/peachwm/config.lua

Roadmap

  • No longer require exiting peachwm upon input config changes
  • Allow status bar requests (swaymsg like)
  • Add smartgaps
  • Implement scratchpad workspaces
  • Add animations via scenefx
S
Description
PeachWM is a Wayland Compositor that is powerfully simple for the X11 lifestyle.
Readme GPL-3.0
1.2 MiB
Languages
C 92.8%
Makefile 5.4%
Lua 1.8%