Personal tools

Xmonad/Using xmonad in Gnome

From HaskellWiki

< Xmonad(Difference between revisions)
Jump to: navigation, search
m (Fix typo in natty instructions)
(Fedora 10 and further links: add general fedora section)
Line 164: Line 164:
I also had to uninstall the appmenu stuff to get my menus back for some reason. Not sure what the problem with the global menus are in Natty since the Gnome Classic session gets normal in-window menus and the appmenu panel still works. With xmonad it just seems totally broken.
I also had to uninstall the appmenu stuff to get my menus back for some reason. Not sure what the problem with the global menus are in Natty since the Gnome Classic session gets normal in-window menus and the appmenu panel still works. With xmonad it just seems totally broken.
The Fedora xmonad package provides /usr/share/applications/xmonad.desktop
and /usr/share/xsessions/xmonad.desktop, and the generic instructions
above should just work there (but not the "Simple Hybrid Alternative").
===Fedora 10 and further links===
===Fedora 10 and further links===

Revision as of 08:04, 22 April 2011




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.9.

This is an update to the previous page on Xmonad/Using xmonad in Gnome/0.6.

2 Setting up Gnome to use Xmonad

Overall most people on a variety of distros seem to get best results by using an applications/xmonad.desktop file and running a full gnome session replacing only gnome's window manager. They tell gnome-session to use xmonad instead of metacity by running:

# gconftool-2 -s /desktop/gnome/session/required_components/windowmanager xmonad --type string
Doing this from inside a full gnome session will replace metacity with xmonad and continue to run all the other gnome daemons and apps. See below to set up a separate customized xmonad or ~/.xsession based session separate from your gnome one.

For xmonad to start automatically on login you need an applications/xmonad.desktop file on your system. If your distro doesn't provide it, create the following file:

$ cat /usr/share/applications/xmonad.desktop
[Desktop Entry]

Alternatively, you can create the above as ~/.local/share/applications/xmonad.desktop for the current user only.

To run a separate xmonad session in addition to gnome session(s) you need an xsessions/xmonad.desktop file. To start a minimal xmonad session from gdm (see notes* below to run more than just xmonad on login), create the following file:

$ cat /usr/share/xsessions/xmonad.desktop 
[Desktop Entry]
Comment=Lightweight tiling window manager

Your display manager must also be able to find the xmonad executable. If you are not using your distro package manager to install xmonad, for best results configure your build to install xmonad to a location in the system environment like /usr/local/bin/.

*NOTE: Using an xsessions/xmonad.desktop file that runs a custom script xmonad.start instead of just plain xmonad is also how to add other startup actions to the gdm xmonad.desktop startup, such as starting gnome daemons, apps, etc. See arjuna's blog for more details. (simono says: Creating /usr/share/xsessions/xmonad.desktop and /usr/local/bin/xmonad.start files is the preferred method for configuring an alternative window manager. The applications/xmonad.desktop file is still required.) However, see the xsession section below to continue using the classic ~/.xsession method to run a custom session.

2.1 A Simple Hybrid Alternative

There is also a hybrid method that seems to work much more simply and easily than the custom start script, while still allowing XMonad to be chosen as a separate session. applications/xmonad.desktop and xsessions/xmonad.desktop are created as above. And, as above, xsessions/xmonad.desktop points to a custom xmonad.start script. But, the contents of the xmonad.start script are simply the following:

export WINDOW_MANAGER=xmonad

This gives all the bells and whistles of gnome, including integrated logout support, etc, while also allowing xmonad and gnome to be selected as separate sessions from the login screen. Note that if you go this road with Ubuntu 10.04 (tested with gnome 2.30.0), you will also need to unset the gconf windowmanager setting.

gconftool-2 -u /desktop/gnome/session/required_components/windowmanager

That alone didn't work for me. I have this in my xmonad.start instead

gconftool-2 -t string -s /desktop/gnome/session/required_components/windowmanager xmonad
gconftool-2 -t string -s /desktop/gnome/applications/window_manager/current xmonad

After startup I am running

killall compiz
xmonad &

2.2 Ubuntu

I had tried above methods described by "simple hybrid", but they are not staight forward and didn't work.

export WINDOW_MANAGER=/path to xmonad

If once I execute "gnome-wm" manually, after that it works, I got xmonad integrated in gnome well. However, once I switch to my gnome session, and then return back to my xmonad session, the xmonad window manager isn't run, just as I log into the gnome session.

After delving into gnome-wm script and some analysis and many try, I found out why the plain script did not work. Because I had turned on the "auto save gnome session" function, I guess gnome-session wouldn't call gnome-wm again when I change from gnome session to xmonad session. So I disable the save session function, and remove the files in .config/gnome-session/saved-session/*.

Finally it works! This indirectly prove the above guess is right. Actually I had put this script to xmonad-custom.start, then I can have gnome and xmonad session seperated, and they don't interfere with the other. I think this method is simple yet elegant, and easy to understand.

2.3 Ubuntu Karmic

Follow the above general instructions. Most people will probably want to use the "simple hybrid method", .xsession, or use gconftool to replace metacity in a full gnome session running all the other supporting gnome apps. You may also wish to install xterm if you don't already have it, since it's the terminal used by the default xmonad setup, at least till you get the gnomeConfig up and running as discussed in later sections.

2.3.1 using xsession under karmic

*NOTE:Ubuntu Karmic Koala users still can use their ~/.xsession scripts to run xmonad. For this, you need:

1. sudo mkdir /etc/X11/sessions

2. put into /etc/X11/sessions/Xsessions.desktop:

[Desktop Entry]
Comment=This runs ~/.xsession

3. Then Xsession entry will appear in gdm, and will work as it worked for many years.

WINDOW_MANAGER variable looks still working, you can use smth like:

export WINDOW_MANAGER="/path/to/xmonad"
exec gnome-session 

in your ~/.xsession

For more info on this, check gdm bug description at launchpad [1].

2.3.2 xmonad-0.9 for karmic

This mailing list thread has instructions to use a PPA for newer xmonad, dzen, xmobar.

2.4 Ubuntu Jaunty

At least 3 XMonad users have found that the ~/.gnomerc will not work on Jaunty Ubuntu when one is upgrading from Intrepid; apparently the ~/.gconf/ directory is incompatible or something, so Gnome/Ubuntu will not read .gnomerc and any settings in it will be ignored.

The work-around is essentially to remove .gconf entirely. On the next login, a fresh default .gconf will be created and .gnomerc will be read. This of course implies that one's settings and preferences will also be removed, and one will have to redo them. (Copying over selected directories from the old .gconf to the new one may or may not work.)

Or alternatively, the following worked for me (without touching .gconf or .gnomerc or exports): Add an xmonad launcher in the gnome-session-properties and then execute:

   $ gconftool -t string -s /desktop/gnome/applications/window_manager/current xmonad
   $ gconftool -t string -s /desktop/gnome/session/required_components/windowmanager xmonad
   $ killall metacity; xmonad &

Also make sure to add the /usr/share/applications/xmonad.desktop file shown above, if it's not already present. This lets gnome know that xmonad is a windowmanager and where to look for it.

2.4.1 newer haskell and xmonad for jaunty

gspreemann's PPA has newer haskell toolchain without some of the setup problems others have had, as well as xmonad-0.9.

2.5 Ubuntu Intrepid

This forum thread has instructions for making Gnome play nice with xmonad on intrepid.

2.6 Ubuntu Natty

On Natty you need to create a new gnome session description at

/usr/share/gnome-session/sessions/xmonad.session which should look something like this

[GNOME Session]

You should also create a file at /usr/share/xsessions/xmonad.desktop with contents like this

[Desktop Entry]
Comment=Lightweight tiling window manager + Gnome
Exec=gnome-session --session=xmonad

And then select the Xmonad session when logging in with GDM.

I also had to uninstall the appmenu stuff to get my menus back for some reason. Not sure what the problem with the global menus are in Natty since the Gnome Classic session gets normal in-window menus and the appmenu panel still works. With xmonad it just seems totally broken.

2.7 Fedora

The Fedora xmonad package provides /usr/share/applications/xmonad.desktop and /usr/share/xsessions/xmonad.desktop, and the generic instructions above should just work there (but not the "Simple Hybrid Alternative").

2.8 Fedora 10 and further links

This mailing list thread contains fedora 10 specific setup instructions, but also a bunch of other gnome setup links if you are having trouble with the above methods.

None of this worked for me (Colin Adams). What did work was to start gconf-editor and change desktop/gnome/session/required_components/windowmanager from metacity to $HOME/bin/xmonad . I then have to type "xmonad" from a terminal. (Likely the /usr/share/applications/xmonad.desktop file was missing. Generally this is the cause of xmonad not starting on login. Check ~/.xsession-errors for additional clues.)

2.9 Using the startup applications menu to modify your gnome session

An alternative to using gconftool to change the window manager in a gnome session:

On many distros you can replace metacity in your full gnome session by using the gnome menus to create a new item in the System>Preferences>Startup Applications menu Programs tab to run xmonad as window manager. (Disable "automatic saving of session components on logout" to use this setup method.)

For example, for Name: you could use "Window Manager XMonad", then for Program: use xmonad. Un-check the old Metacity one (typically called Window Manager and using Program gnome-wm). Don't delete or over-write it so you can switch back if you want. Click the checkbox to turn on the new "Window Manager XMonad" entry instead, save your session, log out and log back in choosing gnome-session. If it's not already there, this will create the applications/xmonad.desktop file discussed above. (Not a great method for people who switch frequently between metacity, compiz, and xmonad.)

3 Configure Xmonad to interoperate with Gnome

xmonad and gnome-panel

3.1 Using the Config.Gnome module

For xmonad-0.8 or greater, see Basic DE Integration for a simple three line xmonad.hs configuration that:

  • integrates docks and gnome-panel using ewmh's
  • allows gap-toggling
  • binds the gnome run dialog to mod-p, and mod-shift-q to save your session and logout
  • otherwise keeps xmonad defaults.

It is a good starting point. You can then come back and add some of the features below once everything's working.

Once the Config.Gnome module set up, you may want to customize these gnome settings.

3.1.1 Keys

Use EZConfig to add keybindings. Note that you must use gnomeConfig whereever defaultConfig is mentioned.

import XMonad
import XMonad.Util.EZConfig
main = xmonad $ gnomeConfig
        { terminal = "urxvt"
        , modMask = mod4Mask -- set the mod key to the windows key
                 [ ("M-m", spawn "echo 'Hi, mom!' | dzen2 -p 4")
                 , ("M-<Backspace>", withFocused hide) -- N.B. this is an absurd thing to do

3.1.2 ManageHooks

Be sure to include the default gnome manageHook when overriding manageHooks so that xmonad can leave a gap for gnome-panel:

main = xmonad gnomeConfig
   , manageHook = composeAll
        [ manageHook gnomeConfig
        , title =? "foo" --> doShift "2"
        -- needs: import XMonad.Hooks.ManageHelpers (isFullscreen,doFullFloat)
        , isFullscreen --> doFullFloat

3.1.3 Layouts

When overriding the default layouts, you must manually apply the desktopLayoutModifiers layout modifier.

import XMonad.Config.Desktop (desktopLayoutModifiers)
main = xmonad gnomeConfig
    , layoutHook = desktopLayoutModifiers (Tall 1 0.03 0.5 ||| Full)
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

This step is not required, but some users prefer to disable the desktop. From the command line execute:

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

(Using recent gnome and xmonad I found that it was necessary.)

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 Display XMonad logHook in gnome-panel

See xmonad log applet for a third party panel applet to display xmonad's logHook in gnome-panel via dbus. You will also need to install the DBus package from hackage. For more detailed installation and setup instructions, see Installing xmonad log applet.

4.4 Key bindings for switching desktops

4.4.1 In 1 dimension: CycleWS

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:

main = xmonad gnomeConfig
    { modMask = mod4Mask }
    -- moving workspaces
    , ("M-<Left>",    prevWS )
    , ("M-<Right>",   nextWS )
    , ("M-S-<Left>",  shiftToPrev )
    , ("M-S-<Right>", shiftToNext )

4.4.2 In 2 dimensions: Plane

If Gnome is configured to lay out desktops in more than one line, it's possible to navigate with Ctrl+Alt+Up/Bottom also. The contrib module XMonad.Actions.Plane, available in the xmonad-0.8 or greater. The keybindings can be incorporated in with EZConfig as such:

import XMonad
import XMonad.Config.Gnome
import XMonad.Actions.Plane
import XMonad.Util.EZConfig
import qualified Data.Map as M
main = xmonad $ gnomeConfig
    { terminal = "urxvt"
    , modMask = mod4Mask -- set the mod key to the windows key
        [ ("M-m", spawn "echo 'Hi, mom!' | dzen2 -p 4")
        , ("M-<Backspace>", withFocused hide) -- N.B. this is an absurd thing to do
    -- NOTE: planeKeys requires xmonad-0.9 or greater
    M.toList (planeKeys mod4Mask GConf Finite)

Actions.WorkspaceCursors can be used to navigate workspaces arranged in three or more dimensions.

4.5 Logging out of the Gnome session vs. quitting Xmonad

When running Xmonad as above, it is launched by gnome-session, the "Gnome session manager." Quitting Xmonad in this situation will not log you out. If you make no changes, using mod+shift+q will leave you with all your applications still running and no window manager to navigate them! There are several remedies for this.

  * Run 'xmonad &' from a command line.
  * Quit X using Alt-Ctrl-Backspace.
  * Rebind mod+shift+q

4.5.1 Rebind mod+shift+q

To avoid exiting Xmonad and being stuck with no window manager, you might rebind mod+shift+q to execute the gnome-session "log out" functionality. This will of course prevent you from "quitting" Xmonad in the normal way, which may or may not be desirable. When the session logs out, the X11 server is terminated, which will in turn terminate all running X11 applications, including Xmonad.

(TODO: improve the description of changes that need to be made here.)

   , ("M-S-q", spawn "gnome-session-save --gui --logout-dialog") )

4.5.2 Configure rudimentary power management

It might be useful to include bindings for hibernation, screen locking, and other assorted basic functions. While Gnome provides the capability to do so, it's functionality is limited (Mod4 cannot be used as a mask), and you may prefer to have Xmonad manage it. Fortunately, these things can be controlled from the command line, and the following bindings may help. (NB: These are for one handed use of Dvorak control; make sure to bind them to something more fitting. They also use mod1 not to clash with mod4 by accident.)

    -- Lock Screen
    , ("M-S-l",    spawn "gnome-screensaver-command -l")
    -- Logout
    , ("M1-M-S-l", spawn "gnome-session-save --gui --kill")
    -- Sleep
    , ("M1-S-'",   spawn " suspend")
    -- Reboot
    , ("M1-S-,",   spawn " reboot")
    -- Deep Sleep
    , ("M1-S-.",   spawn " hibernate")
    -- Death
    , ("M1-S-p",   spawn " shutdown")

4.5.3 Configure the session manager to relaunch Xmonad

You can configure the Gnome Session Manager to restart Xmonad whenever it exits (i.e., if you haven't rebound mod-shift-q.) This is rarely a useful feature as xmonad has its builtin compile-and-restart (mod-q), but it will prevent you from accidentally ending up with no window manager and no way to launch one.

However, as of version 0.7, XMonad does not itself communicate with any session managers in they way they prefer, so setting things up takes some hackery:

(TBD: steps, see also Xmonad/Using_xmonad_in_Gnome/0.5#Preparing_your_GNOME_session)

4.6 Modify terminal

If you use prompts, e.g. SshPrompt, due to an issue with how the terminal is invoked (see [2]), you will need to either wrap gnome-terminal as described here and then do something like

main = xmonad $ gnomeConfig { terminal = "/path/to/gnome-terminal-wrapper" }

or use a different terminal altogether

main = xmonad $ gnomeConfig { terminal = "xterm" }