Join GitHub today
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] Encoding=UTF-8 Name=StumpWM Comment=Login using StumpWM Exec=/path/to/stumpwm-binary Type=XSession
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
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` export GNOME_KEYRING_CONTROL export SSH_AUTH_SOCK export GPG_AGENT_INFO export GNOME_KEYRING_PID 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.
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 stumpwm.info. 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 stumpwm.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.