https://wiki.archlinux.org/api.php?action=feedcontributions&user=Olvar&feedformat=atomArchWiki - User contributions [en]2024-03-29T11:17:39ZUser contributionsMediaWiki 1.41.0https://wiki.archlinux.org/index.php?title=Stumpwm&diff=114648Stumpwm2010-08-22T09:02:30Z<p>Olvar: </p>
<hr />
<div>[[Category:Tiling WMs (English)]]<br />
[[Category:HOWTOs (English)]]<br />
<br />
== Introduction ==<br />
<br />
StumpWM is a tiling, full-screen window manager written entirely in<br />
Common Lisp. The successor to the cult classic [[Ratpoison]] window<br />
manager ("GNU Screen to the power of X"), StumpWM adds all the<br />
flexibility and hackability of common lisp, allowing the user to make<br />
modifications to the source of the window manager even while it's<br />
running.<br />
<br />
From the [http://www.nongnu.org/stumpwm/ StumpWM homepage]:<br />
<br />
If you're tired of flipping through themes like channel-surfing, and<br />
going from one perfect-except-for-just-one-thing window manager to<br />
another even-more-broken-in-some-other-way then perhaps Stumpwm can<br />
help.<br />
<br />
Stumpwm attempts to be customizable yet visually minimal. There are<br />
no window decorations, no icons, and no buttons. It does have various<br />
hooks to attach your personal customizations, and variables to tweak.<br />
<br />
Want to see it in action? A StumpWM user created<br />
a [http://www.archive.org/details/TheStumpWMExperience video].<br />
<br />
== Installation ==<br />
<br />
==== With Clisp ====<br />
<br />
# Get and create these packages from AUR in the following order making sure to have makepkg install dependencies first (makepkg -s):<br />
#* [http://aur.archlinux.org/packages.php?ID=15188 clisp-new-clx]<br />
#* [http://aur.archlinux.org/packages.php?ID=18800 cl-asdf]<br />
#* [http://aur.archlinux.org/packages.php?ID=14549 cl-ppcre]. To get this to install, I had to comment out the dependency line in the PKGBUILD.<br />
#* [http://aur.archlinux.org/packages.php?ID=12996 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.<br />
# Make sure to install each one (sudo pacman -U name.pkg.tar.gz) before installing the next.<br />
# See the [[Makepkg]] article for details on downloading and installing from AUR (compiling/creating package and installing).<br />
<br />
==== With SBCL ====<br />
<br />
===== With Lispy =====<br />
[http://common-lisp.net/project/lispy/ Lispy] is a library manager for Common Lisp. It is easy to set up with SBCL.<br />
# Install SBCL<br />
#* <tt>$ pacman -S sbcl</tt><br />
# Install Lispy<br />
#* <tt>$ mkdir ~/.lispy ; cd !$</tt><br />
#* <tt>$ curl http://common-lisp.net/project/lispy/releases/lispy-all-0.5.tar.gz | tar xz ; cd ~ </tt><br />
#* <tt>$ echo -e "(require :asdf)\n(load (merge-pathnames #p\".lispy/lispy-all-0.5/asdf-config.lisp\"\n(user-homedir-pathname)))" >> ~/.sbclrc</tt><br />
#* <tt>$ curl http://common-lisp.net/project/lispy/key.asc | gpg --import</tt><br />
# Install Libraries<br />
#* <tt>$ sbcl</tt><br />
#** <tt>* (asdf:oos 'asdf:load-op :lispy)</tt><br />
#** <tt>* (dolist (module '(:clx :cl-ppcre)) (lispy:install (lispy:module-by-name module)))</tt><br />
# Proceed from installing git in the AUR instructions.<br />
<br />
===== With asdf-install =====<br />
# Install SBCL<br />
#* <tt># pacman -S sbcl</tt><br />
# Install Libraries<br />
#* <tt># sbcl </tt><br />
#** <tt>* (require 'asdf)</tt><br />
#** <tt>* (require 'asdf-install)</tt><br />
#** <tt>* (asdf-install:install 'clx)</tt><br />
#** <tt>* (asdf-install:install 'cl-ppcre)</tt><br />
#Proceed from installing git in the AUR instructions.<br />
<br />
===== With AUR =====<br />
# Install SBCL<br />
#* <tt>pacman -S sbcl</tt><br />
# 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.<br />
#* If you really don't want to use a PKGBUILD here, you can also use asdf-install to install clx.<br />
# Install [http://aur.archlinux.org/packages.php?do_Details=1&ID=14549&O=0&L=0&C=0&K=cl-ppcre&SB=n&SO=a&PP=25&do_MyPackages=0&do_Orphans=0&SeB=nd cl-ppcre]<br />
#* Again, this can be installed with asdf-install if you really don't like PKGBUILDs.<br />
# Install git<br />
#* <tt>pacman -S git</tt><br />
# Install [http://aur.archlinux.org/packages.php?ID=12996 stumpwm] from AUR.<br />
#* Alternately, you can check it out directly from the git repo., as described on the [http://www.nongnu.org/stumpwm/ homepage]. Read the directions and check the StumpWM wiki for compilation instructions.<br />
<br />
Also, look at [http://bbs.archlinux.org/viewtopic.php?pid=543537#p543537 this post] if you run into troubles.<br />
<br />
== Documentation and Support ==<br />
<br />
If you installed StumpWM by hand or still have the source lying<br />
around, there's a TeXInfo manual.<br />
<br />
There's also a [http://stumpwm.antidesktop.net/ wiki], an IRC channel<br />
(#stumpwm) on Freenode, and a mailing list. For more information, of<br />
course, see [http://www.nongnu.org/stumpwm/ the project's website].<br />
<br />
== Tweaking ==<br />
<br />
See the wiki for a variety of useful tweaks for your .stumpwmrc.<br />
<br />
If you're an emacs user, you'll find an emacs minor mode for editing<br />
StumpWM files (and interfacing with the program <tt>stumpish</tt>, but<br />
more on that below) in the contrib/ directory of the StumpWM source.<br />
If you're using clisp, this file can also be found in<br />
<tt>/usr/share/stumpwm/</tt>.<br />
<br />
<tt>stumpish</tt> is the STUMP window manager Interactive SHell. It's<br />
a program that allows the user to interact with StumpWM while it's<br />
running, from the comfort of a terminal (or using the emacs mode). It<br />
can be found in the contrib/ directory of the StumpWM source. If you<br />
use clisp, this file can also be found in <tt>/usr/bin/</tt>.<br />
<br />
<h4>Happy hacking!</h4></div>Olvar