Personal tools

Xmonad/Installing xmonad

From HaskellWiki

< Xmonad(Difference between revisions)
Jump to: navigation, search
(cabal install)
Current revision (23:31, 28 December 2011) (edit) (undo)
(→Mac OS X: Added alternative install method using Nix.)
 
(25 intermediate revisions not shown.)
Line 2: Line 2:
== Read me first ==
== Read me first ==
-
After installing, you'll have an <code>xmonad</code> binary on your system. From there, you'll need to [[Xmonad/Configuring your login manager|wire xmonad up to your login manager]].
+
After installing, you'll have an <code>xmonad</code> binary on your system. From there, you'll need to [[Xmonad/Frequently_asked_questions#How_can_I_use_xmonad_with_a_display_manager.3F_.28xdm.2C_kdm.2C_gdm.29|wire xmonad up to your login manager]].
== Linux ==
== Linux ==
=== Arch ===
=== Arch ===
-
$ pacman -S xmonad # for the core package
+
$ pacman -S xmonad-contrib # for the xmonad core and contrib packages
-
$ pacman -S xmonad-contrib # for the contrib package
+
or else:
 +
$ pacman -S xmonad # for just the xmonad core package
See [http://wiki.archlinux.org/index.php/XMonad xmonad on ArchWiki] for more info.
See [http://wiki.archlinux.org/index.php/XMonad xmonad on ArchWiki] for more info.
=== Debian ===
=== Debian ===
 +
To install:
 +
$ apt-get install xmonad # for just the xmonad binary, without the ability to configure
 +
In addition to that, if you want to write a configuration file, you should get one of these:
 +
$ apt-get install libghc6-xmonad-contrib-dev # for all of xmonad core and xmonad-contrib (depends on the following pkg)
 +
$ apt-get install libghc6-xmonad-dev # for just xmonad core
 +
 +
There are also -doc and -prof suffixes for various packages. I'm not sure what they contain.
 +
 +
Note: The are backports available for debian etch at http://newpeople.debian.org/~jps/etch/.
=== Fedora ===
=== Fedora ===
 +
To install:
 +
$ yum install xmonad
 +
 +
Additionally install ghc-xmonad-devel and ghc-xmonad-contrib-devel
 +
 +
$ yum install ghc-xmonad-contrib-devel
 +
 +
xmonad is also available in EPEL for rhel6.
=== Gentoo ===
=== Gentoo ===
 +
 +
$ emerge xmonad-contrib
 +
# the contrib package depends on xmonad so it gets also installed
 +
 +
if you only want to install xmonad without contrib you could use:
 +
$ emerge xmonad
 +
 +
An actively maintained [[Gentoo|haskell]] overlay contains many
 +
newer or more obscure versions of projects, including ebuilds for
 +
darcs xmonad/contrib, cabal-install, haskellmode for vim, and many
 +
other goodies.
=== Gobo ===
=== Gobo ===
=== NixOS ===
=== NixOS ===
 +
 +
To install:
 +
 +
#nix-env --install xmonad
 +
 +
the correct version for your arch should be then installed and you will have to take the configuration from there, currently (2011-08-18) this does not result in a working xmonad.
=== Slackware ===
=== Slackware ===
Line 26: Line 61:
=== Ubuntu ===
=== Ubuntu ===
-
$ apt-get install xmonad # for the xmonad binary
+
See [[#Debian]].
-
$ apt-get install libghc6-xmonad-dev # to allow configuration through xmonad.hs
+
-
$ apt-get install libghc6-xmonad-contrib-dev # for all of the contrib modules
+
-
Note: On Hardy Heron and earlier, the libghc6-x11-dev package was compiled without Xinerama support. This means that if you want multi-monitor support, you will either need to upgrade to Intrepid Ibez or compile xmonad (and the Haskell X11 library on which it depends) [[#Generic (from tarball)|from tarball]].
+
Note: On Hardy Heron and earlier, the libghc6-x11-dev package was compiled without Xinerama support. This means that if you want multi-monitor support, you have three options:
 +
* upgrade to >= Intrepid Ibex
 +
* install xmonad (and the Haskell X11 library on which it depends) through one of the [[#Generic]] options
 +
* follow the instructions in [http://basildoncoder.com/blog/2008/08/10/ubuntu-xmonad-and-an-ode-to-apt/ this blog post] to recompile the libghc6-x11-dev yourself (unverified)
== BSD ==
== BSD ==
=== FreeBSD ===
=== FreeBSD ===
 +
 +
For only the window manager:
 +
 +
# cd /usr/ports/x11-wm/hs-xmonad
 +
# sudo make install distclean
 +
 +
And the contrib package:
 +
 +
# cd /usr/ports/x11-wm/hs-xmonad-contrib
 +
# sudo make install distclean
 +
=== NetBSD ===
=== NetBSD ===
=== OpenBSD ===
=== OpenBSD ===
Line 42: Line 89:
== Mac OS X ==
== Mac OS X ==
 +
Install ghc using [http://www.macports.org/ MacPorts]:
 +
$ port install ghc
 +
And then follow one of the [[#Generic]] instructions.
 +
 +
Alternatively install a ghc wrapper and xmonad with [http://nixos.org/nix/ Nix].
 +
$ nix-env -i <package>
 +
 +
See more at [[Xmonad/Using xmonad on Apple OSX]].
 +
 +
== Generic ==
-
== Generic (from tarball) ==
+
=== From tarball ===
-
== Generic (from Hackage) ==
+
=== From Hackage ===
xmonad can be installed from source on any system with an up-to-date Haskell toolchain:
xmonad can be installed from source on any system with an up-to-date Haskell toolchain:

Current revision

XMonad


Contents

1 Read me first

After installing, you'll have an xmonad binary on your system. From there, you'll need to wire xmonad up to your login manager.

2 Linux

2.1 Arch 

 $ pacman -S xmonad-contrib # for the xmonad core and contrib packages

or else: 

 $ pacman -S xmonad         # for just the xmonad core package

See xmonad on ArchWiki for more info.

2.2 Debian

To install: 

 $ apt-get install xmonad                     # for just the xmonad binary, without the ability to configure

In addition to that, if you want to write a configuration file, you should get one of these: 

 $ apt-get install libghc6-xmonad-contrib-dev # for all of xmonad core and xmonad-contrib (depends on the following pkg)
 $ apt-get install libghc6-xmonad-dev         # for just xmonad core

There are also -doc and -prof suffixes for various packages. I'm not sure what they contain.

Note: The are backports available for debian etch at http://newpeople.debian.org/~jps/etch/.

2.3 Fedora

To install: 

 $ yum install xmonad

Additionally install ghc-xmonad-devel and ghc-xmonad-contrib-devel 

 $ yum install ghc-xmonad-contrib-devel

xmonad is also available in EPEL for rhel6.

2.4 Gentoo 

 $ emerge xmonad-contrib 
 # the contrib package depends on xmonad so it gets also installed

 if you only want to install xmonad without contrib you could use:
 $ emerge xmonad

 An actively maintained haskell overlay contains many
 newer or more obscure versions of projects, including ebuilds for
 darcs xmonad/contrib, cabal-install, haskellmode for vim, and many
 other goodies.

2.5 Gobo

2.6 NixOS

To install: 

  #nix-env --install xmonad

the correct version for your arch should be then installed and you will have to take the configuration from there, currently (2011-08-18) this does not result in a working xmonad.

2.7 Slackware

2.8 Source Mage

2.9 Ubuntu

See #Debian.

Note: On Hardy Heron and earlier, the libghc6-x11-dev package was compiled without Xinerama support. This means that if you want multi-monitor support, you have three options:

  • upgrade to >= Intrepid Ibex
  • install xmonad (and the Haskell X11 library on which it depends) through one of the #Generic options
  • follow the instructions in this blog post to recompile the libghc6-x11-dev yourself (unverified)

3 BSD

3.1 FreeBSD

For only the window manager: 

 # cd /usr/ports/x11-wm/hs-xmonad
 # sudo make install distclean

And the contrib package: 

 # cd /usr/ports/x11-wm/hs-xmonad-contrib
 # sudo make install distclean

3.2 NetBSD

3.3 OpenBSD

xmonad is in the ports tree. To install it, 

 sudo pkg_add xmonad

4 Mac OS X

Install ghc using MacPorts: 

 $ port install ghc

And then follow one of the #Generic instructions.

Alternatively install a ghc wrapper and xmonad with Nix. 

 $ nix-env -i <package>

See more at Xmonad/Using xmonad on Apple OSX.

5 Generic

5.1 From tarball

5.2 From Hackage

xmonad can be installed from source on any system with an up-to-date Haskell toolchain: 

 $ cabal install xmonad
Retrieved from "http://www.haskell.org/haskellwiki/Xmonad/Installing_xmonad"

Category: XMonad