From ArchWiki
Revision as of 13:44, 22 February 2010 by Tss (talk | contribs) (With SBCL)
Jump to: navigation, search


StumpWM is a tiling, full-screen window manager written entirely in Common Lisp. The successor to the cult classic Ratpoison window manager ("GNU Screen to the power of X"), StumpWM adds all the flexibility and hackability of common lisp, allowing the user to make modifications to the source of the window manager even while it's running.

From the StumpWM homepage:

If you're tired of flipping through themes like channel-surfing, and
going from one perfect-except-for-just-one-thing window manager to
another even-more-broken-in-some-other-way then perhaps Stumpwm can
Stumpwm attempts to be customizable yet visually minimal. There are
no window decorations, no icons, and no buttons. It does have various
hooks to attach your personal customizations, and variables to tweak.

Want to see it in action? A StumpWM user created a video.


With Clisp

  1. Get and create these packages from AUR in the following order making sure to have makepkg install dependencies first (makepkg -s):
  2. Make sure to install each one (sudo pacman -U name.pkg.tar.gz) before installing the next.
  3. See the Makepkg article for details on downloading and installing from AUR (compiling/creating package and installing).
  • Important - At least as of 09/10/2009, there are are a few changes that need to be made to the PKGBUILD files (after untarring) for this to work.
    1. In the PKGBUILD of clisp-new-clx:
      1. Add 'ffcall' as a dependency.
      2. Add --with-dynamic-ffi as an option to the ./configure line.
    2. In the PKGBUILD of cl-asdf comment out the line installing the LICENSE file (since it no longer exists in the same place in the git repo and isn't included in the AUR package).


With Lispy

Lispy is a library manager for Common Lisp. It is easy to set up with SBCL.

  1. Install SBCL
    • $ pacman -S sbcl
  2. Install Lispy
  3. Install Packages
    • $ sbcl
      • * (asdf:oos 'asdf:load-op :lispy)
      • * (dolist (module '(:clx :cl-ppcre)) (lispy:install (lispy:module-by-name module)))
  4. Proceed from installing git in the manual instructions.
With asdf-install
  1. Install SBCL
    • $ pacman -S sbcl
  2. Install Libraries
    • $ sbcl
      • * (require 'asdf)
      • * (require 'asdf-install)
      • * (asdf-install:install 'clx)
      • * (asdf-install:install 'cl-ppcre)
  1. Install SBCL
    • pacman -S sbcl
  2. Install clx from AUR.
    • If you really don't want to use a PKGBUILD here, you can also use asdf-install to install clx.
  3. Install cl-ppcre
    • Again, this can be installed with asdf-install if you really don't like PKGBUILDs.
  4. Install git
    • pacman -S git
  5. Install stumpwm from AUR.
    • Alternately, you can check it out directly from the git repo., as described on the homepage. Read the directions and check the StumpWM wiki for compilation instructions.
    • Note: The preceding seems to be outdated as the only package in AUR is stumpwm-git.

Also, look at this post if you run into troubles.

Documentation and Support

If you installed StumpWM by hand or still have the source lying around, there's a TeXInfo manual.

There's also a wiki, an IRC channel (#stumpwm) on Freenode, and a mailing list. For more information, of course, see the project's website.


See the wiki for a variety of useful tweaks for your .stumpwmrc.

If you're an emacs user, you'll find an emacs minor mode for editing StumpWM files (and interfacing with the program stumpish, but more on that below) in the contrib/ directory of the StumpWM source. If you're using clisp, this file can also be found in /usr/share/stumpwm/.

stumpish is the STUMP window manager Interactive SHell. It's a program that allows the user to interact with StumpWM while it's running, from the comfort of a terminal (or using the emacs mode). It can be found in the contrib/ directory of the StumpWM source. If you use clisp, this file can also be found in /usr/bin/.

Happy hacking!