xmonad-config is the xmonad configuration used by Vic Fryzel.

If you are unfamiliar with xmonad, it is a tiling window manager that is notoriously minimal, stable, beautiful, and featureful. If you find yourself spending a lot of time organizing or managing windows, you may consider trying xmonad.

However, xmonad can be somewhat difficult to configure if you're new to Haskell or even to xmonad itself.

This project contains a completely working and very usable xmonad configuration "out of the box". If you are just starting out with xmonad, this will give you a configuration that I personally use for around 12 hours every day. Thought has been put into the colors, key bindings, layouts, and supplementary scripts to make life easier.

This project is also recommended for advanced xmonad users, who may just not want to reinvent the wheel. All source provided with this project is well documented and simple to customize.

For source code, or to contribute, see the xmonad-config project page.

• xmonad 0.9.1 or 0.9.2
• xmonad-contrib 0.9.1 or 0.9.2
• xmobar 0.11.1 or 0.13
• stalonetray 0.8.0
• dmenu 4.0
• yeganesh 2.2
• scrot 0.8

sudo pacman -S xmonad xmonad-contrib xmobar stalonetray dmenu scrot \
    cabal-install xcompmgr
sudo cabal update
cabal install --global yeganesh

sudo aptitude install xmonad libghc-xmonad-contrib-dev xmobar stalonetray \
    suckless-tools scrot cabal-install xcompmgr
sudo cabal update
sudo cabal install --global yeganesh

Installing xmonad-config is a matter of backing up any xmonad configuration you may already have, cloning the git repository, and updating your PATH.

cd
mv .xmonad .xmonad.orig
git clone https://github.com/vicfryzel/xmonad-config.git .xmonad

Once xmonad-config is installed, you also need to ensure you can actually start xmonad. The mechanism to do this varies based on each environment, but here are some instructions for some common login managers.

ln -s ~/.xmonad/bin/xsession ~/.xsession
# Logout, login from lightdm/xdm/kdm/gdm

ln -s ~/.xmonad/bin/xsession ~/.xinitrc
# Logout, login from slim

After starting xmonad, use the following keyboard shortcuts to function in your new window manager. I recommend you print these out so that you don't get stranded once you logout and back in.

Once cloned, xmonad-config is laid out as follows.

All xmonad configuration is in ~/.xmonad/xmonad.hs. This includes things like key bindings, colors, layouts, etc. You may need to have some basic understanding of Haskell in order to modify this file, but most people have no problems.

Most of the xmobar configuration is in ~/.xmonad/xmobar.hs.

All scripts are in ~/.xmonad/bin/. Scripts are provided to do things like take screenshots, start the system tray, start dmenu, or fix your multi-head layout after a fullscreen application may have turned off one of the screens.

Colors set in the xmobar config and dmenu script are meant to coincide with the IR_Black terminal and vim themes.