Difference between revisions of "Stumpwm"

From ArchWiki
Jump to: navigation, search
(replace old-style direct package links with Pkg/AUR templates)
(update Pkg/AUR templates (https://github.com/lahwaacz/wiki-scripts/blob/master/update-package-templates.py))
 
(29 intermediate revisions by 15 users not shown)
Line 1: Line 1:
 
[[Category:Tiling WMs]]
 
[[Category:Tiling WMs]]
StumpWM is a tiling, full-screen window manager written entirely in
+
[[ja:Stumpwm]]
Common Lisp. The successor to the cult classic [[Ratpoison]] window
+
StumpWM is a tiling, keyboard driven X11 window manager written entirely in
manager ("GNU Screen to the power of X"), StumpWM adds all the
+
Common Lisp.
flexibility and hackability of common lisp, allowing the user to make
+
 
 +
The successor to the cult classic [[Ratpoison]], 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 is
 
modifications to the source of the window manager even while it is
running.
+
running. It is also known as "the emacs of WMs."
 +
 
 +
From [https://stumpwm.github.io/ StumpWM's homepage]:
  
From the [http://www.nongnu.org/stumpwm/ StumpWM homepage]:
+
:"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.
  
:''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.''
+
:* Hack the good hack
:''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.''
+
:* Debug your good hack
 +
:* Customize your window manager
 +
:While it's running That's right. With a 100% Common Lisp window manager there's no stopping the hacks. Just re-eval and GO!"
  
 
Want to see it in action? A StumpWM user created
 
Want to see it in action? A StumpWM user created
Line 17: Line 23:
 
== Installation ==
 
== Installation ==
  
=== With SBCL (recommended, will run faster) ===
+
[[Install]] {{AUR|stumpwm-git}}. It supports multiple common-lisp implementations.
  
==== With Quicklisp (recommended) ====
+
SBCL is recommended for maximum performance.
  
{{Box RED|WARNING:|Only use root to install SBCL and, if you want to, run "make install".}}
+
=== With SBCL ===
 
+
Install these packages in the following order:
# Install SBCL
+
* {{Pkg|sbcl}}
#* {{Ic|pacman -S sbcl}}
+
* {{AUR|clx-git}}
# Get Quicklisp at [http://beta.quicklisp.org the Quicklisp website]
+
* {{AUR|cl-ppcre}}
#* {{Ic|curl -O http://beta.quicklisp.org/quicklisp.lisp}}
+
* {{AUR|stumpwm-git}}
# Load Quicklisp with SBCL
+
#* {{Ic|sbcl --load quicklisp.lisp}}
+
# Install Quicklisp
+
#* {{Ic|(quicklisp-quickstart:install)}} or {{Ic|(quicklisp-quickstart:install :path "path/of/your/choice")}}
+
# Add it to your SBCL init file
+
#* {{Ic|(ql:add-to-init-file)}}
+
# Check for updates of Quicklisp (not needed if you have just downloaded it)
+
#* {{Ic|(ql:update-client)}}
+
# Check for updates on Quicklisp
+
#* {{Ic|(ql:update-all-dists)}}
+
# Install CLX and CL-PPCRE
+
#* {{Ic|(ql:quickload "clx")}}
+
#* {{Ic|(ql:quickload "cl-ppcre")}}
+
# Quit SBCL with (quit)
+
# Get the git version of StumpWM
+
#* {{Ic|git clone git://github.com/sabetts/stumpwm.git}}
+
# Get into the stumpwm folder and start compiling
+
#* {{Ic|cd stumpwm && ./autogen.sh && ./configure && make}}
+
#* You can optionally run "make install" as root.
+
# Put the StumpWM binary path into your .xinit and have fun! :)
+
 
+
''Optional: Install slime/swank for nonstop real-time hacking'':
+
# Install swank server
+
#* {{Ic|(ql:quickload "swank")}}
+
# Install slime-helper
+
#* {{Ic|(ql:quickload "quicklisp-slime-helper")}}
+
# Paste the following into your dot-emacs
+
#* {{Ic|(load (expand-file-name "/path/to/slime-helper.el"))}}
+
#* {{Ic|(setq inferior-lisp-program "sbcl")}}
+
# Now put the following into your .stumpwmrc or just eval during your stumpwm-session
+
#* {{Ic|(require 'swank)}}
+
#* {{Ic|(swank:create-server)}}
+
# Connect Emacs/Slime to your stumpwm-session using
+
#* {{Ic| M-x slime-connect}}
+
 
+
==== With AUR ====
+
# Install SBCL
+
#* {{Ic|pacman -S sbcl}}
+
# Install [https://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 do not want to use a PKGBUILD here, you can also use asdf-install to install clx.
+
# Install [https://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]
+
#* Again, this can be installed with asdf-install if you really do not like PKGBUILDs.
+
# Install git
+
#* {{Ic|pacman -S git}}
+
# Install [https://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.
+
  
 
=== With Clisp ===
 
=== With Clisp ===
 
+
Install these packages from AUR in the following order:
# Get and create these packages from AUR in the following order making sure to have makepkg install dependencies first (makepkg -s):
+
* {{AUR|clisp-new-clx}}
#* {{AUR|clisp-new-clx}}
+
* {{AUR|cl-asdf}}{{Broken package link|{{aur-mirror|cl-asdf}}}}
#* {{AUR|cl-asdf}}
+
* {{AUR|cl-ppcre}}
#* {{AUR|cl-ppcre}}.  To get this to install, I had to comment out the dependency line in the PKGBUILD.
+
* {{AUR|stumpwm-git}}
#* {{AUR|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.
+
# Make sure to install each one (sudo pacman -U name.pkg.tar.gz) before installing the next.
+
# See the [[Makepkg]] article for details on downloading and installing from AUR (compiling/creating package and installing).
+
  
 
Also, look at [https://bbs.archlinux.org/viewtopic.php?pid=543537#p543537 this post] if you run into troubles.
 
Also, look at [https://bbs.archlinux.org/viewtopic.php?pid=543537#p543537 this post] if you run into troubles.
Line 88: Line 45:
 
== Documentation and Support ==
 
== Documentation and Support ==
  
If you installed StumpWM by hand or still have the source lying
+
There is a TeXInfo manual included in the AUR package, the source, and [https://stumpwm.github.io/git/stumpwm-git.html online].
around, there is a TeXInfo manual.
+
  
There is also a [http://stumpwm.svkt.org/cgi-bin/wiki.pl wiki], an IRC channel
+
There is also a [http://github.com/sabetts/stumpwm/wiki wiki], an IRC channel
 
(#stumpwm) on Freenode, and a mailing list. For more information, of
 
(#stumpwm) on Freenode, and a mailing list. For more information, of
course, see [http://www.nongnu.org/stumpwm/ the project's website].
+
course, see [https://stumpwm.github.io/ the project's website].
  
 
== Tweaking ==
 
== Tweaking ==
Line 112: Line 68:
  
 
== Troubleshooting ==
 
== Troubleshooting ==
If you cannot start stumpwm and get
+
* If you have problems configuring multiple monitors, maybe you need to install 'xorg-xdpyinfo' package.
 +
 
 +
* If you cannot start stumpwm and get
 
             debugger invoked on a SB-INT:SIMPLE-PARSE-ERROR in thread
 
             debugger invoked on a SB-INT:SIMPLE-PARSE-ERROR in thread
 
         #:
 
         #:
Line 120: Line 78:
 
         (PARSE-INTEGER "" :START 0 :END NIL :RADIX 10 :JUNK-ALLOWED NIL)
 
         (PARSE-INTEGER "" :START 0 :END NIL :RADIX 10 :JUNK-ALLOWED NIL)
  
In the REPL,It can be solved by delete the .Xauthority in your home diretory.
+
in the REPL, it can be solved by deleting {{ic|~/.Xauthority}}. See [https://github.com/sabetts/stumpwm/issues/1 this issue on github]
You can refer it at[https://github.com/sabetts/stumpwm/issues/1 Issue on github]
+

Latest revision as of 11:58, 25 December 2015

StumpWM is a tiling, keyboard driven X11 window manager written entirely in Common Lisp.

The successor to the cult classic Ratpoison, 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 is running. It is also known as "the emacs of WMs."

From StumpWM's homepage:

"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.
  • Hack the good hack
  • Debug your good hack
  • Customize your window manager
While it's running That's right. With a 100% Common Lisp window manager there's no stopping the hacks. Just re-eval and GO!"

Want to see it in action? A StumpWM user created a video.

Installation

Install stumpwm-gitAUR. It supports multiple common-lisp implementations.

SBCL is recommended for maximum performance.

With SBCL

Install these packages in the following order:

With Clisp

Install these packages from AUR in the following order:

Also, look at this post if you run into troubles.

Documentation and Support

There is a TeXInfo manual included in the AUR package, the source, and online.

There is 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 are an emacs user, you will find an emacs minor mode for editing StumpWM files (and interfacing with the program stumpish, but more on that below) in the contrib/ directory of the StumpWM source. If you are using clisp, this file can also be found in /usr/share/stumpwm/.

stumpish is the STUMP window manager Interactive SHell. It is a program that allows the user to interact with StumpWM while it is 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 /usr/bin/.

Troubleshooting

  • If you have problems configuring multiple monitors, maybe you need to install 'xorg-xdpyinfo' package.
  • If you cannot start stumpwm and get
           debugger invoked on a SB-INT:SIMPLE-PARSE-ERROR in thread
       #:
       no non-whitespace characters in string "".
       Type HELP for debugger help, or (SB-EXT:QUIT) to exit from SBCL.
       (no restarts: If you did not do this on purpose, please report it as a bug.)
       (PARSE-INTEGER "" :START 0 :END NIL :RADIX 10 :JUNK-ALLOWED NIL)

in the REPL, it can be solved by deleting ~/.Xauthority. See this issue on github