Thomas Atkinson edited this page Jul 8, 2017 · 5 revisions


There are two main ways of starting StumpWM depending on wether you use a login manager or a straight .xinitrc or .xsession. Using a login manager will allow you to switch between multiple window managers/desktop environments depending on your preference while the other options will directly open StumpWM bypassing the login manager. Using the login manager method will be more useful if you use a Linux Distribution which starts X11 and a Login Manager by default.

Using a Login Manager

Create the file stumpwm.desktop in /usr/share/xsessions/ containing the following:

[Desktop Entry]
Comment=Login using StumpWM

Remember to change /path/to/stumpwm-binary to the correct path. If you installed StumpWM using "$ sudo make install" the path will be /usr/local/bin/stumpwm

Using .xinitrc or .xsession


 exec /path/to/stumpwm-binary

into your .xinitrc if you start X using startx or into .xsession if you use xdm or similar. A more complicated .xinitrc may look like:

#! /bin/bash
eval `gnome-keyring-daemon --start --components=gpg,pkcs11,secrets,ssh`

exec xmodmap ~/.xmodmap
exec xsetroot -cursor_name left_ptr
exec xset s off
exec xset b off
exec ssh-agent /usr/local/bin/stumpwm

This sets up the gnome-keyring properly so that applications can use it, as well as changing some important X11 "features" like the bell or sticky keys. Finally it launches stumpwm with the ssh-agent so that you can manage ssh keys appropriately.

Start Script

Shell script meant to be executed as end client from xinitrc (or xsession or any script you start stumpwm from)

The script will pop up a window asking what to do, you can start or update stumpwm (from cvs), start an other wm (twm by default) or exit.

Each time you exit the current wm, the script will pop up this window again, so you can switch to an other wm without killing X (and all the running windows)

You'll probably have to modify it to reflect your settings.

Obtain it here: StumpWMStartScript

Learning the Ropes

StumpWM's makefile also builds It contains all sorts of information, including beginner's.

If for some reason it did not, you can generate it yourself by entering the directory you unpacked StumpWM into and running:

 $ makeinfo stumpwm.texi

You may read it by any means you please,

 $ info

will work fine. If you are unfamiliar with info, try:

 $ info info

After you've installed Stumpwm with make install you can also access the manual via C-h i and then searching for StumpWM from Emacs.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.