StartUp

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

Introduction

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

Place

 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`
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.

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 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.

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.