Difference between revisions of "Stumpwm"

From ArchWiki
Jump to: navigation, search
(With Quicklisp (recommended))
m (replacing <tt>text</tt> with {{Codeline|text}})
Line 33: Line 33:
  
 
# Install SBCL
 
# Install SBCL
#* <tt>pacman -S sbcl</tt>
+
#* {{Codeline|pacman -S sbcl}}
 
# Get Quicklisp at [http://beta.quicklisp.org the Quicklisp website]
 
# Get Quicklisp at [http://beta.quicklisp.org the Quicklisp website]
#* <tt>curl -O http://beta.quicklisp.org/quicklisp.lisp</tt>
+
#* {{Codeline|curl -O http://beta.quicklisp.org/quicklisp.lisp}}
 
# Load Quicklisp with SBCL
 
# Load Quicklisp with SBCL
#* <tt>sbcl --load quicklisp.lisp</tt>
+
#* {{Codeline|sbcl --load quicklisp.lisp}}
 
# Install Quicklisp
 
# Install Quicklisp
#* <tt>(quicklisp-quickstart:install)</tt>
+
#* {{Codeline|(quicklisp-quickstart:install)}}
 
# Add it to your SBCL init file
 
# Add it to your SBCL init file
#* <tt>(ql:add-to-init-file)</tt>
+
#* {{Codeline|(ql:add-to-init-file)}}
 
# Check for updates of Quicklisp (not needed if you've just downloaded it)
 
# Check for updates of Quicklisp (not needed if you've just downloaded it)
#* <tt>(ql:update-client)</tt>
+
#* {{Codeline|(ql:update-client)}}
 
# Check for updates on Quicklisp
 
# Check for updates on Quicklisp
#* <tt>(ql:update-all-dists)</tt>
+
#* {{Codeline|(ql:update-all-dists)}}
 
# Install CLX and CL-PPCRE
 
# Install CLX and CL-PPCRE
#* <tt>(ql:quickload "clx")</tt>
+
#* {{Codeline|(ql:quickload "clx")}}
#* <tt>(ql:quickload "cl-ppcre")</tt>
+
#* {{Codeline|(ql:quickload "cl-ppcre")}}
 
# Quit SBCL with (quit)
 
# Quit SBCL with (quit)
 
# Get the git version of StumpWM
 
# Get the git version of StumpWM
#* <tt>git clone git://git.savannah.nongnu.org/stumpwm.git</tt>
+
#* {{Codeline|git clone git://git.savannah.nongnu.org/stumpwm.git}}
 
# Get into the stumpwm folder and start compiling
 
# Get into the stumpwm folder and start compiling
#* <tt>cd stumpwm && ./autogen.sh && ./configure && make</tt>
+
#* {{Codeline|cd stumpwm && ./autogen.sh && ./configure && make}}
 
#* You can optionally run "make install" as root.
 
#* You can optionally run "make install" as root.
 
# Put the StumpWM binary path into your .xinit and have fun! :)
 
# Put the StumpWM binary path into your .xinit and have fun! :)
Line 59: Line 59:
 
''Optional: Install slime/swank for nonstop real-time hacking'':
 
''Optional: Install slime/swank for nonstop real-time hacking'':
 
# Install swank server
 
# Install swank server
#* <tt>(ql:quickload "swank")</tt>
+
#* {{Codeline|(ql:quickload "swank")}}
 
# Install slime-helper
 
# Install slime-helper
#* <tt>(ql:quickload "quicklisp-slime-helper")</tt>
+
#* {{Codeline|(ql:quickload "quicklisp-slime-helper")}}
 
# Paste the following into your dot-emacs
 
# Paste the following into your dot-emacs
#* <tt>(load (expand-file-name "/path/to/slime-helper.el"))</tt>
+
#* {{Codeline|(load (expand-file-name "/path/to/slime-helper.el"))}}
#* <tt>(setq inferior-lisp-program "sbcl")</tt>
+
#* {{Codeline|(setq inferior-lisp-program "sbcl")}}
 
# Now put the following into your .stumpwmrc or just eval during your stumpwm-session
 
# Now put the following into your .stumpwmrc or just eval during your stumpwm-session
#* <tt>(require 'swank)</tt>
+
#* {{Codeline|(require 'swank)}}
#* <tt>(swank:create-server)</tt>
+
#* {{Codeline|(swank:create-server)}}
 
# Connect Emacs/Slime to your stumpwm-session using
 
# Connect Emacs/Slime to your stumpwm-session using
#* <tt> M-x slime-connect</tt>
+
#* {{Codeline| M-x slime-connect}}
  
 
===== With AUR =====
 
===== With AUR =====
 
# Install SBCL
 
# Install SBCL
#* <tt>pacman -S sbcl</tt>
+
#* {{Codeline|pacman -S sbcl}}
 
# Install [http://aur.archlinux.org/packages.php?do_Details=1&ID=12084&O=0&L=0&C=0&K=clx&SB=n&SO=a&PP=25&do_MyPackages=0&do_Orphans=0&SeB=nd clx] from AUR.
 
# Install [http://aur.archlinux.org/packages.php?do_Details=1&ID=12084&O=0&L=0&C=0&K=clx&SB=n&SO=a&PP=25&do_MyPackages=0&do_Orphans=0&SeB=nd clx] from AUR.
 
#* If you really don't want to use a PKGBUILD here, you can also use asdf-install to install clx.
 
#* If you really don't want to use a PKGBUILD here, you can also use asdf-install to install clx.
Line 79: Line 79:
 
#* Again, this can be installed with asdf-install if you really don't like PKGBUILDs.
 
#* Again, this can be installed with asdf-install if you really don't like PKGBUILDs.
 
# Install git
 
# Install git
#* <tt>pacman -S git</tt>
+
#* {{Codeline|pacman -S git}}
 
# Install [http://aur.archlinux.org/packages.php?ID=12996 stumpwm] from AUR.
 
# Install [http://aur.archlinux.org/packages.php?ID=12996 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.
 
#* 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.
Line 109: Line 109:
  
 
If you're an emacs user, you'll find an emacs minor mode for editing
 
If you're an emacs user, you'll find an emacs minor mode for editing
StumpWM files (and interfacing with the program <tt>stumpish</tt>, but
+
StumpWM files (and interfacing with the program {{Codeline|stumpish}}, but
 
more on that below) in the contrib/ directory of the StumpWM source.
 
more on that below) in the contrib/ directory of the StumpWM source.
 
If you're using clisp, this file can also be found in
 
If you're using clisp, this file can also be found in
<tt>/usr/share/stumpwm/</tt>.
+
{{Codeline|/usr/share/stumpwm/}}.
  
<tt>stumpish</tt> is the STUMP window manager Interactive SHell. It's
+
{{Codeline|stumpish}} is the STUMP window manager Interactive SHell. It's
 
a program that allows the user to interact with StumpWM while 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
 
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
 
can be found in the contrib/ directory of the StumpWM source. If you
use clisp, this file can also be found in <tt>/usr/bin/</tt>.
+
use clisp, this file can also be found in {{Codeline|/usr/bin/}}.
  
 
<h4>Happy hacking!</h4>
 
<h4>Happy hacking!</h4>

Revision as of 03:20, 5 September 2011


Introduction

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

Installation

With SBCL (recommended, will run faster)

With Quicklisp (recommended)
WARNING: Only use root to install SBCL and, if you want to, run "make install".
  1. Install SBCL
  2. Get Quicklisp at the Quicklisp website
  3. Load Quicklisp with SBCL
  4. Install Quicklisp
  5. Add it to your SBCL init file
  6. Check for updates of Quicklisp (not needed if you've just downloaded it)
  7. Check for updates on Quicklisp
  8. Install CLX and CL-PPCRE
  9. Quit SBCL with (quit)
  10. Get the git version of StumpWM
  11. Get into the stumpwm folder and start compiling
  12. Put the StumpWM binary path into your .xinit and have fun! :)

Optional: Install slime/swank for nonstop real-time hacking:

  1. Install swank server
  2. Install slime-helper
  3. Paste the following into your dot-emacs
  4. Now put the following into your .stumpwmrc or just eval during your stumpwm-session
  5. Connect Emacs/Slime to your stumpwm-session using
With AUR
  1. Install 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
  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.

With Clisp

  1. Get and create these packages from AUR in the following order making sure to have makepkg install dependencies first (makepkg -s):
    • clisp-new-clx
    • cl-asdf
    • cl-ppcre. To get this to install, I had to comment out the dependency line in the PKGBUILD.
    • stumpwm-git. Alternatively, download the latest version from the web site and follow the install instructions. The executable can stay in your home directory tree.
  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).

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.

Tweaking

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 Template:Codeline, 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 Template:Codeline.

Template:Codeline 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 Template:Codeline.

Happy hacking!