Gentoo Wiki


Desktop environments

Lightweight desktop environments

Window managers

Compositing window managers


Nico's PekWM desktop, Theme: DIVERSITY
Nico's PekWM desktop, Theme: DIVERSITY


What is PekWM?

The Pek Window Manager is a window manager for X, based on aewm++, but it has evolved enough that it no longer resembles aewm++ at all. It has a much expanded feature-set, including window grouping (similar to ion, pwm, or fluxbox), autoproperties, xinerama, keygrabber that supports keychains, and much more.

For more information please visit the project page: [1]


Unmasking the latest version (do not forget to replace ~arch with your arch ie. ~x86)

echo "x11-wm/pekwm ~arch" >> /etc/portage/package.keywords

Installing is simple, just do

emerge pekwm

The first start

If you don't plan on using a graphical login manager such as gdm, you can configure the global /etc/env.d/90xsession and change the line XSESSION="Xsession" to XSESSION="pekwm". Else, as per-user setting edit ~/.xinitrc to run it via startx:

File: ~/.xinitrc
exec pekwm

If you are using a login manager, you should create a .desktop entry:

File: /usr/share/xsessions/pekwm.desktop
 [Desktop Entry]
 Comment=Use PekWM as your window manager

Now start it with startx or per login manager and play around a litte. The default theme is quite ugly but the gentoo ebuild contains some additional themes. If you don't like it change it: A right-click brings up the menu the menu, then navigate to "pekwm -> themes" and select another one.

Basic usage

Lets keep it really simple here, all the things are covered in the awesome documentation.

The important things are the right and the middle mouse button: The right mouse button brings up the menu and the middle one the "focus frame" menu (the window list).


This part is covered in the documentation too.


You can obtain themes from There also is a theme ebuild with about 60 themes in portage, called x11-themes/pekwm-themes-hewphoria.

If a theme looks horribly broken, don't use it. This happens probably because the theme syntax has changed. (In x11-themes/pekwm-themes-hewphoria only working themes are included)

Final notes

Enjoy PekWM and read the documentation or vice versa.

Retrieved from ""

Last modified: Sat, 06 Sep 2008 07:34:00 +0000 Hits: 10,165