stumpwm-init

Custom stumpwm init. Should work out of the box without any configuration other than adding

(stumpwm:load-module :stumpwm-init)

to your .stumpwmrc (although there is some optional configuration!).

Features

• Key remappings for Okular (pdf viewer) if it is installed. The bindings are a Spacemacs-like Emacs/vim mix (which you may not like).
• Include a few lightweight contrib modules.
• poison command to banish and turn off mouse (q)
• Call xterm with the Hack font.
• Use a package to keep the namespace clean, export symbols for optional configuration.

Optional Configuration

xterm

Install the Hack font, or add your own to stumpwm-init:*xterm-font*.

(setf stumpwm-init:*xterm-font* "Hack"
      stumpwm-init:*xterm-font-pt* 12)

deftermcom

Write commands which will be run and opened in the terminal. Useful for curses programs.

(stumpwm-init:deftermcom nmtui "-e nmtui" xterm)

poison

Find your mouse’s name with xinput --list, and set it to stumpwm-init:*my-mouse*. Turns the mouse all the way off using xinput.

app-menu

Add programs to the app menu (bound to M-` by default) using pushnew-apps. This keeps them sorted alphabetically. Any programs in stumpwm-init:*app-menu* need to be installed to work:

• emacs
• web browser

Example:

(stumpwm-init:pushnew-apps '("eclipse" "eclipse")
                           '("spotify" "spotify")
                           '("gimp" "gimp")
                           '("office" "openoffice")
                           '("pass"
                             ("copy" pass:pass-copy-menu)
                             ("generate" pass:pass-generate))
                           '("PDF" "okular")
                           '("sound" "pavucontrol"))

Keybindings

Most can be found under the prefix (bound to C-i), but M-` (no prefix) is the app-menu.