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

−

going from one perfect-except-for-just-one-thing window manager to

+

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

−

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

Want to see it in action? A StumpWM user created

Line 27:

Line 17:

== Installation ==

== Installation ==

−

==== With Clisp ====

+

=== With SBCL (recommended, will run faster) ===

−

# Get and create these packages from AUR in the following order making sure to have makepkg install dependencies first (makepkg -s):

+

==== With Quicklisp (recommended) ====

−

#* [http://aur.archlinux.org/packages.php?ID=15188 clisp-new-clx]

−

#* [http://aur.archlinux.org/packages.php?ID=18800 cl-asdf]

−

#* [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.

−

#* [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.

−

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

−

==== With SBCL ====

+

{{Box RED|WARNING:|Only use root to install SBCL and, if you want to, run "make install".}}

−

===== With Lispy =====

−

[http://common-lisp.net/project/lispy/ Lispy] is a library manager for Common Lisp. It is easy to set up with SBCL.

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

+

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

−

#* Note: The preceding seems to be outdated as the only package in AUR is stumpwm-git.

+

+

=== With Clisp ===

−

Also, look at [http://bbs.archlinux.org/viewtopic.php?pid=543537#p543537 this post] if you run into troubles.

+

# 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|cl-asdf}}

+

#* {{AUR|cl-ppcre}}. To get this to install, I had to comment out the dependency line in the PKGBUILD.

+

#* {{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.

== Documentation and Support ==

== Documentation and Support ==

If you installed StumpWM by hand or still have the source lying

If you installed StumpWM by hand or still have the source lying

−

around, there's a TeXInfo manual.

+

around, there is a TeXInfo manual.

−

There's also a [http://stumpwm.antidesktop.net/ 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 [http://www.nongnu.org/stumpwm/ the project's website].

Line 93:

Line 99:

See the wiki for a variety of useful tweaks for your .stumpwmrc.

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

+

If you are an emacs user, you will 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 {{Ic|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 are using clisp, this file can also be found in

−

<tt>/usr/share/stumpwm/</tt>.

+

{{Ic|/usr/share/stumpwm/}}.

−

<tt>stumpish</tt> is the STUMP window manager Interactive SHell. It's

+

{{Ic|stumpish}} is the STUMP window manager Interactive SHell. It is

−

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 is

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 {{Ic|/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)

−

<h4>Happy hacking!</h4>

+

In the REPL,It can be solved by delete the .Xauthority in your home diretory.

+

You can refer it at[https://github.com/sabetts/stumpwm/issues/1 Issue on github]

Revision as of 17:16, 1 July 2013

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

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.

Documentation and Support

If you installed StumpWM by hand or still have the source lying
around, there is a TeXInfo manual.

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 delete the .Xauthority in your home diretory.
You can refer it atIssue on github