Personal tools

Xmonad/Using xmonad in Gnome

From HaskellWiki

< Xmonad(Difference between revisions)
Jump to: navigation, search
m (Link to full-size image; not thumbnail)
m (cleanup, verbiage, indentation)
Line 14: Line 14:
 
==Setting up Gnome to use Xmonad==
 
==Setting up Gnome to use Xmonad==
   
The easiest way is to let Gnome start Xmonad itself by modifying ''~/.gnomerc'' to contain
+
The easiest way is to let Gnome start Xmonad itself by setting the environment variable WINDOW_MANAGER to point to the xmonad executable before Gnome starts. On most systems, this means modifying one of ''~/.xprofile'' or ''~/.gnomerc'' to contain:
   
 
export WINDOW_MANAGER=/usr/bin/xmonad
 
export WINDOW_MANAGER=/usr/bin/xmonad
   
if the binary is somewhere in your home directory. Be sure to avoid using a tilda. It doesn't work in this expression. Instead use the absolute path:
+
or, if the binary is in your home directory,
export WINDOW_MANAGER=/home/<userid>/bin/xmonad
+
  +
export WINDOW_MANAGER=${HOME}/bin/xmonad
   
 
==Configure Xmonad to interoperate with Gnome==
 
==Configure Xmonad to interoperate with Gnome==
Line 30: Line 30:
 
import XMonad.Hooks.EwmhDesktops
 
import XMonad.Hooks.EwmhDesktops
   
main = xmonad $ defaultConfig
+
main = xmonad defaultConfig
{ manageHook = manageDocks <+> manageHook defaultConfig
+
{ manageHook = manageDocks <+> manageHook defaultConfig
, logHook = ewmhDesktopsLogHook
+
, logHook = ewmhDesktopsLogHook
, layoutHook = avoidStruts $ layoutHook defaultConfig
+
, layoutHook = avoidStruts $ layoutHook defaultConfig
, modMask = mod4Mask
+
, modMask = mod4Mask
}
+
}
 
</haskell>
 
</haskell>
   
Line 54: Line 54:
 
From the command line execute:
 
From the command line execute:
   
gconftool --type boolean --set /apps/nautilus/preferences/show_desktop false
+
gconftool --type boolean --set /apps/nautilus/preferences/show_desktop false
   
 
===Changing desktop background===
 
===Changing desktop background===
Line 77: Line 77:
   
 
<haskell>
 
<haskell>
main = xmonad $ defaultConfig
+
main = xmonad defaultConfig
{ modMask = mod4Mask
+
{ modMask = mod4Mask
}
+
}
 
</haskell>
 
</haskell>
   
Line 89: Line 89:
 
import XMonad.Hooks.ManageDocks
 
import XMonad.Hooks.ManageDocks
 
main = xmonad defaultConfig
 
main = xmonad defaultConfig
{ manageHook = manageDocks <+> manageHook defaultConfig
+
{ manageHook = manageDocks <+> manageHook defaultConfig
, layoutHook = avoidStruts $ layoutHook defaultConfig
+
, layoutHook = avoidStruts $ layoutHook defaultConfig
}
+
}
 
</haskell>
 
</haskell>
   
Line 97: Line 97:
   
 
<haskell>
 
<haskell>
main = xmonad $ defaultConfig
+
main = xmonad defaultConfig
{ defaultGaps = [(24,24,0,0)]
+
{ defaultGaps = [(24,24,0,0)]
}
+
}
 
</haskell>
 
</haskell>
   
Line 108: Line 108:
 
<haskell>
 
<haskell>
 
import XMonad.Hooks.EwmhDesktops
 
import XMonad.Hooks.EwmhDesktops
main = xmonad $ defaultConfig
+
main = xmonad defaultConfig
{ logHook = ewmhDesktopsLogHook
+
{ logHook = ewmhDesktopsLogHook
}
+
}
 
</haskell>
 
</haskell>
   

Revision as of 22:20, 31 March 2008

Xmonad-logo-small.png

XMonad

Contents

1 Introduction

A screenshot of xmonad cooperating with gnome

Xmonad makes an excellent drop-in replacement for Gnome's default window manager (metacity) giving you a slick tiling window manager. This guide will help you set up Gnome to use Xmonad 0.6.

This is an update to the previous page on Xmonad/Using xmonad in Gnome/0.5, which in turn was an update to the original page on the subject.

2 Setting up Gnome to use Xmonad

The easiest way is to let Gnome start Xmonad itself by setting the environment variable WINDOW_MANAGER to point to the xmonad executable before Gnome starts. On most systems, this means modifying one of ~/.xprofile or ~/.gnomerc to contain:

   export WINDOW_MANAGER=/usr/bin/xmonad

or, if the binary is in your home directory,

   export WINDOW_MANAGER=${HOME}/bin/xmonad

3 Configure Xmonad to interoperate with Gnome

Put this in ~/.xmonad/xmonad.hs:

import XMonad
import XMonad.Hooks.ManageDocks
import XMonad.Hooks.EwmhDesktops
 
main = xmonad defaultConfig
              { manageHook = manageDocks <+> manageHook defaultConfig
              , logHook    = ewmhDesktopsLogHook
              , layoutHook = avoidStruts $ layoutHook defaultConfig
              , modMask    = mod4Mask
              }

This should set up Xmonad to make space for Gnome's panel and status bar automatically.

Having done this, you should now be able to use Gnome with Xmonad, and most things will work. At the time of writing, there are a couple of things that don't fully work: clicking on the taskbar to select a window doesn't focus the window, and clicking on the panel to switch desktops doesn't. Of course you can use the standard Xmonad keys to perform these actions instead.

Explanations of the various options are given below, along with some other things you might want to tweak.

A screenshot of xmonad cooperating with gnome

4 Tweak Gnome to work better with Xmonad

These are a few steps that greatly improves the experience of running Xmonad under Gnome. Note that on some systems the binary gconftool is called gconftool-2.

4.1 Disable the Nautilus desktop

From the command line execute:

   gconftool --type boolean --set /apps/nautilus/preferences/show_desktop false

4.2 Changing desktop background

If you need to change the workspace background programmatically (i.e. from some extension setting in xmonad's configuration file), you can use the command:

   gconftool --type string --set /desktop/gnome/background/picture_filename "/path/to/your/image.png"

4.3 Fixing the pointer

After switching to Xmonad you might notice that the default pointer isn't the one you chose in your beautiful Gnome theme. The way to address this is to run xsetroot during session startup. Open the session configuration dialogue (System -> Preferences -> Sessions). Add a new startup program, choose any name and comment you want but make the command

   /usr/bin/xsetroot -cursor_name left_ptr

5 Tips on configuring Xmonad

Allthe configuration is done in ~/.xmonad/xmonad.hs.

5.1 Change the mod key

The default mod key is alt, which conflicts with Gnome keybindings. In order to use be able to use the keyboard to e.g. getting rid of dialogues we rebind it to the left logo key:

main = xmonad defaultConfig
              { modMask = mod4Mask
              }

5.2 Make space for the panel

ManageDocks makes it possible for Xmonad to work with panels in the way they expect, automatically leaving the appropriate amount of room for them at the edges of the screen. ManageDocks has been enabled in the example configuration above. By itself, configuration looks like this:

import XMonad.Hooks.ManageDocks
main = xmonad defaultConfig
              { manageHook = manageDocks <+> manageHook defaultConfig
              , layoutHook = avoidStruts  $  layoutHook defaultConfig
              }

Prior to version 0.7, Xmonad alternatively supported a gaps option, configured like this:

main = xmonad defaultConfig
              { defaultGaps = [(24,24,0,0)]
              }

5.3 Extended Window Manager Hints

EwmhDesktops makes it possible to let Gnome know about Xmonad windows and workspaces. EwmhDesktops has been enabled in the example configuration above. By itself, configuration looks like this:

import XMonad.Hooks.EwmhDesktops
main = xmonad defaultConfig
              { logHook = ewmhDesktopsLogHook
              }

5.4 Key bindings for switching desktops

Gnome lays out the desktops in a row by default, and uses Ctrl+Alt+Left/Right for switching desktops left/right. To get similar behaviour in Xmonad, you need to add some keybindings. The contrib module XMonad.Actions.CycleWS has some useful actions for cycling workspaces, and I use these keybindings:

    -- moving workspaces
    , ((modMask,               xK_Left  ), prevWS )
    , ((modMask,               xK_Right ), nextWS )
    , ((modMask .|. shiftMask, xK_Left  ), shiftToPrev )
    , ((modMask .|. shiftMask, xK_Right ), shiftToNext )