From ArchWiki
Revision as of 20:38, 24 September 2012 by Ifaigios (Talk | contribs) (Some 'System Settings' not preserved)

Jump to: navigation, search
Summary help replacing me
GNOME 3 provides a modern desktop, rewritten from scratch, using the GTK3+ toolkit.
Template:Graphical user interface overview

From About Us | GNOME:

The GNOME Project was started in 1997 by two then university students, Miguel de Icaza and Federico Mena. Their aim: to produce a free (as in freedom) desktop environment. Since then, GNOME has grown into a hugely successful enterprise. Used by millions of people across the world, it is the most popular desktop environment for GNU/Linux and UNIX-type operating systems. The desktop has been utilised in successful, large-scale enterprise and public deployments, and the project’s developer technologies are utilised in a large number of popular mobile devices.



GNOME 3 has two interfaces:

  • GNOME Shell is the new standard layout using the Mutter window manager. It acts as a composite manager for the desktop, employing hardware graphics acceleration to provide effects aimed at reducing screen clutter.
  • fallback mode is similar to GNOME 2, it uses gnome-panel and Metacity instead of gnome-shell/Mutter. No hardware acceleration is required to run fallback mode.

GNOME-session automatically detects if your computer is incapable of running GNOME Shell and starts fallback mode when appropriate. When you are on fallback mode you can still replace GNOME's default window manager with your preferred one.


GNOME 3 is available in the official repositories and can be installed with two groups of packages:

  • gnome contains the core desktop environment and applications required for the standard GNOME experience.
  • gnome-extra contains various optional tools such as a media player, a calculator, an editor and other non-critical applications that go well with the GNOME desktop. Installing this group is optional.

Note that installing only gnome-extra will not pull the whole gnome group by dependencies: if you really want everything you must explicitly install both groups.

D-Bus daemon

The GNOME desktop requires the D-Bus daemon. Refer to the D-Bus article for setup instructions.

Starting GNOME

Graphical log-in

For the best desktop integration, login manager GDM is recommended. Other login managers can be used in place of GDM. Check out the wiki article on display managers to learn how desktop environments are started.

The login manager is a limited process entrusted with duties that impact the system. The PolicyKit wiki article addresses the topic of system‑wide access control.

Tip: Refer to the GDM article for installation and configuration instructions.

Starting GNOME manually

If you prefer to start GNOME manually from the console, add the following line to your ~/.xinitrc file. Make sure it is the only line (remove the if/fi block from the standard ~/.xinitrc since the if/fi block can cause problems) and the only command starting with exec. See the xinitrc wiki article.

 exec ck-launch-session gnome-session

After the exec command is placed, GNOME can be launched by typing startx.

Using the shell

GNOME cheat sheet

The GNOME web site has a helpful GNOME Shell cheat sheet explaining task switching, keyboard use, window control, the panel, overview mode, and more.

Restarting the shell

After appearance tweaks you are often asked to restart the GNOME shell. You could log out and log back in, but it is simpler and faster to issue the following keyboard command. Restart the shell by pressing Template:Keypress + Template:Keypress then Template:Keypress then Template:Keypress

Shell crashes

Certain tweaks and/or repeated shell restarts may cause the shell to crash when a restart is attempted. In this case, you are informed about the crash and then forced to log out. Some shell changes, such as switching between GNOME Shell and fallback mode, cannot be accomplished via a keyboard restart; you must log out and log back in to effect them.

It is common sense — but worth repeating — that valuable documents should be saved (and perhaps closed) before attempting a shell restart. It is not strictly necessary; open windows and documents usually remain intact after a shell restart.

Shell freezes

Sometimes shell extensions freeze the GNOME Shell. In this case a possible strategy is to switch to another terminal via Template:Keypress, log in, and restart X by

# pkill X

The GNOME Shell then restarts automatically.

Customizing GNOME appearance

Overall appearance

GNOME 3 may have "started from scratch", but like most large software projects it is assembled from parts dating to different eras. There is not one all-encompassing configuration tool. The new Systems Settings tool is a big improvement over previous control panels. System Settings is well-organized, but you may find yourself wishing for more control over system appearance.

You may be familiar with existing configuration tools: some of these still work; many will not. Some settings are not readily exposed for you to change. Indubitably, many settings will migrate to newer tools and/or become exposed as time progresses and the wider community embraces and extends the latest GNOME desktop.


A new command-line tool gsettings stores data in a binary format, unlike previous tools using XML text. A tutorial Customizing the GNOME Shell explores the power of gsettings.

GNOME tweak tool

This graphical tool customizes fonts, themes, titlebar buttons and other settings.

# pacman -S gnome-tweak-tool

Version 3.0.3 only works when gnome-shell is installed (OK if forced to fallback mode). Bugzilla bug report here.

GTK3 theme via settings.ini

Like ~/.gtkrc-2.0 with GTK2+, it is possible to set a GTK3 theme via ${XDG_CONFIG_HOME}/gtk-3.0/settings.ini.

Variable $XDG_CONFIG_HOME is usually set to ~/.config

Adwaita, the default GNOME 3 theme, is a part of gnome-themes-standard. Additional GTK3 themes can be found at Deviantart web site. For example:

  gtk-theme-name = Adwaita
  gtk-fallback-icon-theme = gnome
  # next option is applicable only if selected theme supports it
  gtk-application-prefer-dark-theme = true
  # set font name and dimension
  gtk-font-name = Sans 10

It is necessary to restart the GNOME shell for settings to be applied. More GTK options are found at GNOME developer documentation.

Icon theme

Using gnome-tweak-tool version 3.0.3 and later, you can place any icon theme you wish to use inside ~/.icons.

Usefully, GNOME 3 is compatible with GNOME 2 icon themes, which means you are not stuck with the default icons. To install a new set of icons, copy your desired icon theme's directory to ~/.icons. As an example:

$ cp -R /home/user/Desktop/my_icon_theme ~/.icons

The new theme my_icon_theme is now selectable using gnome-tweak-tool under interface.

Alternatively, you may textually select your icon theme with no need for gnome-tweak-tool. Add the GTK icon theme name to ${XDG_CONFIG_HOME}/gtk-3.0/settings.ini. Please note, not to use "" as your settings would not be recognised then.

... previous lines ...

gtk-icon-theme-name = my_new_icon_theme


See Nautilus.

GNOME panel

Show date in top bar

By default GNOME displays only the weekday and time in the top bar. This can be changed with the following command. Changes take effect immediately.

# gsettings set show-date true

Hiding icons in the top bar

When doing a GNOME install, some unwanted icons might appear in the panel. These icons can be removed either with GNOME shell extensions or by manually editing the GNOME panel script.

Hiding icons with shell extensions

To remove the accessibility icon, one can use the AUR package gnome-shell-extension-noa11y-gitAUR.

Similar extensions can be based on this one for some of the other icons, for example by replacing 'a11y' with 'bluetooth' in the above extension's script.

Manually editing the GNOME panel script

For example, to remove the universal access icon. Remove 'a11y' from the AREA_ORDER line and comment out the 'a11y' line in AREA_SHELL_IMPLEMENTATION

const STANDARD_STATUS_AREA_ORDER = ['ally', 'keyboard', 'volume', 'network', 'bluetooth', 'battery', 'userMenu'];
    'a11y': imports.ui.status.accessibility.ATIndicator
    'volume': imports.ui.status.volume.Indicator,
    'battery': imports.ui.status.power.Indicator,
    'keyboard': imports.ui.status.keyboard.XKBIndicator,
    'userMenu': imports.ui.userMenu.UserMenuButton


const STANDARD_STATUS_AREA_ORDER = ['keyboard', 'volume', 'network', 'bluetooth' 'battery', 'userMenu'];
    //'a11y': imports.ui.status.accessibility.ATIndicator
    'volume': imports.ui.status.volume.Indicator,
    'battery': imports.ui.status.power.Indicator,
    'keyboard': imports.ui.status.keyboard.XKBIndicator,
    'userMenu': imports.ui.userMenu.UserMenuButton

save your results and restart the shell to see results:

  1. Template:Keypress
  2. Template:Keypress
  3. Template:Keypress

Show battery icon

To show the battery tray icon, install gnome-power-manager from the official repositories.

Disable "Suspend" in the status and gdm menu

A quick way to do it system-wide for GNOME 3.2 is to change line 539 of /usr/share/gnome-shell/js/ui/userMenu.js and line 103 of /usr/share/gnome-shell/js/gdm/powerMenu.js. (For GNOME versions prior to 3.2, look at line 153 of /usr/share/gnome-shell/js/ui/statusMenu.js.) This change takes effect the next time GNOME Shell is started.

 // this._haveSuspend = this._upClient.get_can_suspend();  //  Comment this line out.
 this._haveSuspend = false;                                //  Use this line instead.

To accomplish this, paste the following command(s) in your terminal:

 SCRIPTS=`grep -lr get_can_suspend $GNOME_SHELL/js`
 for FILE in $SCRIPTS ; do
       sed -r -i -e 's/[^= ]+.get_can_suspend\(\)/false/' "$FILE"

The above change does not persist after a GNOME version update, however. A more perennial solution is to add the code above in some gdm or system startup script (eg: /etc/rc.local), to keep the "suspend" option disabled after updates.

Alternatively you can install the GNOME shell extension alternative status menu in package gnome-shell-extension-alternative-status-menu.

Eliminate delay when logging out

The following tweak removes the confirmation dialog and sixty second delay for logging out.

This dialog normally appears when you log out with the status menu. This tweak affects the Power Off dialog as well. This is not a system-wide change; it affects only the user who enters this command. The change takes effect immediately after entering the command.

$ gsettings set org.gnome.SessionManager logout-prompt 'false'

Show system monitor

Install the gnome-shell-system-monitor-applet-gitAUR extension available in the AUR.

Show weather information

Install gnome-shell-extension-weather-gitAUR from AUR.

Activity view

Remove entries from Applications view

Like other desktop environments, GNOME uses .desktop files to populate its Applications view. These text files are in /usr/share/applications. It is not possible to edit these files from a folder view ‒ Nautilus does not treat their icons as text files. Use a terminal to display or edit .desktop file entries.

# ls /usr/share/applications
# nano /usr/share/applications/foo.desktop

For system wide changes, edit files in /usr/share/applications. For local changes, make a copy of foo.desktop in your home folder.

$ cp /usr/share/applications/foo.desktop ~/.local/share/applications/

Edit .desktop files to fit your wishes.

Note: Removing a .desktop file does not uninstall an application, but instead removes its desktop integration: MIME types, shortcuts, and so forth.

The following command appends one line to a .desktop file and hides its associated icon from Applications view:

$ echo "NoDisplay=true" >> foo.desktop

Reduce application icon size

One awkward selection of the GNOME designers is their choice of large icons for Applications view. This view is painful when working with a small screen containing many large application icons. There is a way to reduce the icon size. It is done by editing the GNOME-Shell theme.

Edit system files directly (make a backup first) or copy theme files to your local folder and edit these files.

  • For the default theme, edit /usr/share/gnome-shell/theme/gnome-shell.css
  • For user themes, edit /usr/share/themes/<UserTheme>/gnome-shell/gnome-shell.css

Edit gnome-shell.css and replace the following values. Afterward, restart the GNOME shell.

 /* Application Launchers and Grid */
 .icon-grid {
     spacing: 18px;
     -shell-grid-horizontal-item-size: 82px;
     -shell-grid-vertical-item-size: 82px;
 .icon-grid .overview-icon {
     icon-size: 48px;

Disable Activity hot corner hovering

To disable automatic activity view when the hot corner is hovered, edit /usr/share/gnome-shell/js/ui/layout.js (that was panel.js in GNOME 3.0.x) :

 this._corner = new Clutter.Rectangle({ name: 'hot-corner',
                                       width: 1,
                                       height: 1,
                                       opacity: 0,
                                       reactive: true });icon-size: 48px;

and set reactive to false. GNOME Shell needs to be restarted.


Reduce title bar height

  • global - edit /usr/share/themes/Adwaita/metacity-1/metacity-theme-3.xml, search for title_vertical_pad and and reduce its value to a minimum of 0.
  • user-only - copy /usr/share/themes/Adwaita/metacity-1/metacity-theme-3.xml to /home/$USER/.themes/Adwaita/metacity-1/metacity-theme-3.xml, search for title_vertical_pad and reduce its value to a minimum of 0.

Then Restart the GNOME shell.

To restore the original values, install the package gnome-themes-standard from the official repositories or remove /home/$USER/.themes/Adwaita/metacity-1/metacity-theme-3.xml

Reorder titlebar buttons

At present this setting can be changed through dconf-editor.

For example, we move the close and minimize buttons to the left side of the titlebar. Open dconf-editor and locate the key. Change its value to close,minimize: (Colon symbol designates the spacer between left side and right side of the titlebar.) Use whichever buttons in whatever order you prefer. You cannot use a button more than once. Also, keep in mind that certain buttons are deprecated. Restart the shell to see your new button arrangement.

Hide titlebar when maximized

# sed -i -r 's|(<frame_geometry name="max")|\1 has_title="false"|' /usr/share/themes/Adwaita/metacity-1/metacity-theme-3.xml

Restart the GNOME shell. After this tweak, you may find it difficult to un-maximize a window when there is no titlebar to grab.

With suitable keybindings, you should be able to use Template:Keypress, Template:Keypress or Template:Keypress to remedy the situation.

To prevent metacity-theme-3.xml from being overwritten each time package gnome-themes-standard is upgraded, add its name to /etc/pacman.conf with NoUpgrade.

... previous lines ...

# Pacman won't upgrade packages listed in IgnorePkg and members of IgnoreGroup
# IgnorePkg   =
# IgnoreGroup =

NoUpgrade = usr/share/themes/Adwaita/metacity-1/metacity-theme-3.xml    # Do not add a leading slash to the path

... more lines ...

To restore original Adwaita theme values, install the gnome-themes-standard package.

Login screen

Merge-arrows-2.pngThis article or section is a candidate for merging with GDM.Merge-arrows-2.png

Notes: please use the second argument of the template to provide more detailed indications. (Discuss in Talk:GNOME#)
To modify characteristics of the login screen (GDM, the GNOME display manager) the following lines can be executed. The first command allows all users, including "gdm", to access X settings (albeit temporarily). This command creates a temporary vulnerability, so be advised. The second command opens a bash session with the credentials of user "gdm".
Note: For exposition, user gdm's terminal prompt is shown as $. In actuality, it shows something like -bash-4.2$.
# xhost +
# su - gdm -s /bin/bash
$ dbus-launch

The third command prints DBUS_SESSION_BUS_ADDRESS and DBUS_SESSION_BUS_PID. We must export these variables. Either manually export the below two variables shown in the output of dbus-launch like this:

$ export DBUS_SESSION_BUS_ADDRESS=unix:abstract=/tmp/dbus-Jb433gMQHS,guid=fc14d4bf3d000e38276a5a2200000d38
$ export DBUS_SESSION_BUS_PID=4283

Or use the follow command:

$ `dbus-launch | sed "s/^/export /"`

Check to see if dconf-service is running and if not, start it like this

$ /usr/lib/dconf/dconf-service &

Login background image

Once session variables have been exported as explained above, you may issue commands to retrieve or set items used by GDM.

The easiest way to changes all the settings is by launching the Configuration Editor gui with the command

$ dconf-editor

The location of each setting is the same as in the command line style of configuration shown below:

The following is the command-line approach to retrieve or set the file name used for GDM's wallpaper.

 $  GSETTINGS_BACKEND=dconf gsettings get org.gnome.desktop.background picture-uri
 $  GSETTINGS_BACKEND=dconf gsettings set org.gnome.desktop.background picture-uri 'file:///usr/share/backgrounds/gnome/SundownDunes.jpg'
 $  GSETTINGS_BACKEND=dconf gsettings set org.gnome.desktop.background picture-options 'zoom'
 ## Possible values: centered, none, scaled, spanned, stretched, wallpaper, zoom
Note: You must specify a file which user "gdm" has permission to read. GDM cannot read files in your home directory.

An alternative graphical interface to changing themes (gtk3, icons and cursor), the wallpaper and minor other settings of the GDM login screen, you can install gdm3setupAUR from AUR.

Larger font for login

This tweak enlarges the login font with a scaling factor. It is the same method employed by Accessibility Manager on the desktop.

You must export the GDM session variables before performing this tweak.

$ GSETTINGS_BACKEND=dconf gsettings set org.gnome.desktop.interface text-scaling-factor '1.25'

Turning off the sound

This tweak disables the audible feedback heard when the system volume is adjusted (via keyboard) on the login screen. You must first export the GDM session variables.

$ GSETTINGS_BACKEND=dconf gsettings set org.gnome.desktop.sound event-sounds 'false'

If the above tweak does not work for you or you are unable to export the GDM session variables, there is always the easiest solution to the "ready sound" problem: mute or lower the sound while in GDM login screen using the media keys (if available) of your keyboard.

Make the power button interactive

The default installation sets the power button to suspend the system. Power off or Show dialog is a better choice. You must first export the GDM session variables as outlined previously.

 $ GSETTINGS_BACKEND=dconf gsettings set org.gnome.settings-daemon.plugins.power button-power 'interactive'
 $ GSETTINGS_BACKEND=dconf gsettings set org.gnome.settings-daemon.plugins.power button-hibernate 'interactive'
 $ gsettings list-recursively org.gnome.settings-daemon.plugins.power
Warning: Please note that the acpid daemon also handle the "power button" an "hibernate button" event. Running both systems at the same time may lead to unexpected behaviour.

GDM keyboard layout

GDM does not know about your GNOME 3 desktop keyboard settings. To change keyboard settings used by GDM, set your layout using Xorg configuration. Refer to this section of the Beginner's Guide.

Other tips

See GNOME Tips.

Miscellaneous settings

Automatic program launch upon logging in

Specify which programs start automatically after logging in using gnome-session-properties. This tool is part of the gnome-session package.

$ gnome-session-properties

Editing applications menu

gnome-menus provides gmenu-simple-editor which can show/hide menu entries.

alacarteAUR in the AUR provides a more complete menu editor for adding/editing menu entries.

Some 'System Settings' not preserved

GNOME 3 is using systemd (an init daemon for Linux) with more modern capabilities. Previously GNOME programs were altered to use Arch's init functionalities to gather settings but either the maintenance required to do this or possibly this is because of a transitioning to the new init system (read more about this here). Areas that settings will not be preserved are Date and Time and adding ICC profiles in the Color menu and possibly others.

To gain the functionality back, systemd needs to be installed and the gdm.service and NetworkManager.service services need to be enabled.

Move dialog windows

The default configuration for dialogs will not allow you to move them which causes problems in some cases. To change this you will need to use gconf-editor and change this setting:


After the change you will need to restart the shell for it to take affect.

GNOME shell extensions

GNOME Shell can be customized with extensions written by others. These provide features such as a dock or a widget for changing the theme.

Many extensions are collected and hosted by They can be browsed and installed simply activating them in the browser.

Other details on available extensions are found at the WEBUPD8 site. The most recent articles can be found using this WEBUPD8 search link.

Useful extensions provided in the AUR:

gnome-shell-extension-presentation-mode-gitAUR Adds option to inhibit screensaver in the power menu (battery icon).
gnome-shell-extension-weather-gitAUR Displays weather notifications.
gnome-shell-extension-alternative-status-menu-gitAUR Adds "Hibernate" and "Power Off" to the status menu.
gnome-shell-extension-theme-selectorAUR Select a theme in the Activities overview.

To install a custom theme with GNOME Tweak Tool, you need to install the gnome-shell-extension-user-theme-gitAUR package from AUR.

gnome-shell-fripperyAUR An unofficial extension pack providing GNOME2 like features for GNOME3.

Restart the GNOME Shell after installing an extension. See when an extension breaks GNOME for troubleshooting information.

Default file browser/replace Nautilus

You can lure GNOME to use another file browser by editing


and replacing

Exec=nautilus %U

by your browser, for example :

Exec=thunar /

Default terminal

gsettings (which replaces gconftool-2) is used to set the default terminal. The setting affects nautilus-open-terminal (a Nautilus extension). To make urxvt the default, run:

gsettings set org.gnome.desktop.default-applications.terminal exec urxvtc
gsettings set org.gnome.desktop.default-applications.terminal exec-arg "'-e'"
Note: The -e flag is for executing a command. When nautilus-open-terminal invokes urxvtc, it puts a cd command at the end of the command line so that the new terminal starts in the directory you opened it from. Other terminals will require a different (perhaps empty) exec-arg.

Middle mouse button

By default, GNOME 3 disables middle mouse button emulation regardless of Xorg settings (Emulate3Buttons). To enable middle mouse button emulation use:

$ gsettings set org.gnome.settings-daemon.peripherals.mouse middle-button-enabled true

Display dimming

By default GNOME 3 has a ten second idle timeout to dim the screen regardless of the battery and AC state:

gsettings get org.gnome.settings-daemon.plugins.power idle-dim-time

To set a new value type the following

gsettings set org.gnome.settings-daemon.plugins.power idle-dim-time <int>

where <int> is the value in seconds

Alternate window manager

You can use an alternate window manager with GNOME by forcing fallback mode and creating two files:

Note: Xmonad is used as an example, but this works for other window managers.
[GNOME Session]
Name=Xmonad session
[Desktop Entry]
Name=Xmonad GNOME
Comment=Tiling window manager
Exec=gnome-session --session=xmonad

The next time you log in, you should have the ability to choose Xmonad GNOME as your session.

If there isn't a .desktop file for the window manager, you'll need to create one. Example for wmii:

[Desktop Entry]

For more information, see this article on running awesome as the window manager in GNOME.

Hidden features

GNOME 3 hides many useful options which you can customize with dconf-editor. GNOME 3 also supports gconf-editor for settings that have not yet migrated to dconf.

Changing hotkeys

Firstly, use dconf-editor to place a checkmark next to can-change-accels in the key named org.gnome.desktop.interface.

We will replace the hotkey — a.k.a. keyboard shortcut, keyboard accelerator — used by Nautilus to move files to the trash folder.

The default assignment is a somewhat-awkward Template:Keypress.

  • Open Nautilus, select any file, and click Edit on the menu bar.
  • Hover over the Move to Trash menu item.
  • While hovering, press Template:Keypress. The current accelerator is now unset.
  • Press the key that you wish to become the new keyboard accelerator.
  • Press Template:Keypress to make the new accelerator be the Delete key.

Unless you select a file or folder, Move to Trash will be grayed-out. Finally, disable can-change-accels to prevent accidental hotkey changes.

Shutdown via the status menu

Currently, the GNOME designers have hidden the Shutdown option inside the status menu. To shut down your system with the status menu, click the menu and hold down the Template:Keypress key so that the Suspend item changes to Power Off. The subsequent dialog allows you to shut down or restart your system.

If you disable the Suspend menu item system-wide as described elsewhere in this document you do not have to go through these motions.

Another option is to install the Alternative Status Menu extension. See the section on shell extensions. The alternative menu extension installs a new status menu with a non-hidden Power Off entry.

Integrated messaging (Empathy)

Empathy, the engine behind integrated messaging, and all system settings based on messaging accounts will not show up unless the telepathy group of packages or at least one of the backends (telepathy-gabble, or telepathy-haze, for example) is installed.

These packages are not included in default Arch GNOME installs. You can install the Telepathy and optionally any backends with:

# pacman -S telepathy

Without telepathy, Empathy will not open the account management dialog and can get stuck in this state. If this happens -- even after quitting Empathy cleanly -- the /usr/bin/empathy-accounts application can remain running and will need to be killed before you can add any new accounts.

View descriptions of telepathy components on the Telepathy Wiki.

Forcing fallback mode

Your session automatically starts in fallback mode when gnome-shell is not present, or when your hardware cannot handle graphics acceleration — such as running within a virtual machine or running on old hardware.

If you wish to enable fallback mode while still having gnome-shell installed, make the following system change:

Open gnome-control-center. Click the System Info icon. Click Graphics. Change Forced Fallback Mode to ON.

You can alternatively choose the type of session from a terminal with a gsettings command:

$ gsettings set org.gnome.desktop.session session-name 'gnome-fallback'

You may want to log out after making the change. You will see the chosen type of session upon your next login.

To disable forced-fallback mode (that is, launch the normal GNOME Shell) use a value of 'gnome' instead of 'gnome-fallback'.


When an extension breaks GNOME

When enabling shell extensions causes GNOME breakage, you should first remove the user-theme and auto-move-windows extensions from their installation directory.

The installation directory could be one of ~/.local/share/gnome‑shell/extensions, /usr/share/gnome‑shell/extensions, or /usr/local/share/gnome‑shell/extensions. Removing these two extension-containing folders may fix the breakage. Otherwise, isolate the problem extension with trial‑and‑error.

Removing or adding an extension-containing folder to the aforementioned directories removes or adds the corresponding extension to your system. Details on GNOME Shell extensions are available at the GNOME web site.

Extensions do not work after GNOME 3 update

Locate the folder where your extensions are installed. It might be ~/.local/share/gnome-shell/extensions or /usr/share/gnome-shell/extensions.

Edit each occurrence of metadata.json which appears in each extension sub-folder.

Insert: "shell-version": ["3.0"]
Instead of (for example): "shell-version": ["3.0.1"]
You might instead use: "shell-version": ["3.0.0", "3.0.1", "3.0.2"]

"3.0" is the best solution. It indicates the extension works with every 3.0.x GNOME Shell version.

The "Windows" key

By default, this key is mapped to the "overlay-key" to launch the Overview. You can remove this key mapping to free up your Windows Key (also called Mod4), which GNOME calls Super_L, by utilizing gsettings.

Example: gsettings set org.gnome.mutter overlay-key 'Foo';. You can leave out Foo to simply remove any binding to that function.

Note: GNOME also uses Alt+F1 to launch the Overview.

Keyboard Shortcut do not work with only conky running

The gnome-shell keyboard shortcuts like Template:Keypress, Template:Keypress, and the media key shortcuts do not work if conky is the only program running. However if another application like gedit is running, then the keyboard shortcuts work.

solution: edit .conkyrc

own_window yes
own_window_transparent yes
own_window_argb_visual yes
own_window_type dock
own_window_class Conky
own_window_hints undecorated,below,sticky,skip_taskbar,skip_pager

GTK2+ apps show segfaults and fail to launch

Tango-view-refresh-red.pngThis article or section is out of date.Tango-view-refresh-red.png

Reason: oxygen-gtk does not exist. There are only oxygen-gtk2 and oxygen-gtk3 in [extra]. (Discuss in Talk:GNOME#)

That usually happens when oxygen-gtk is installed. This theme appears to conflict with GNOME 3 or GTK3 settings. When oxygen-gtk has been set as a GTK2 theme, GTK2 apps segfault with errors like these:

 (firefox-bin:14345): GLib-GObject-WARNING **: invalid (NULL) pointer instance

(firefox-bin:14345): GLib-GObject-CRITICAL **: g_signal_connect_data: assertion `G_TYPE_CHECK_INSTANCE (instance)' failed
(firefox-bin:14345): Gdk-CRITICAL **: IA__gdk_screen_get_default_colormap: assertion `GDK_IS_SCREEN (screen)' failed
(firefox-bin:14345): Gdk-CRITICAL **: IA__gdk_colormap_get_visual: assertion `GDK_IS_COLORMAP (colormap)' failed
(firefox-bin:14345): Gdk-CRITICAL **: IA__gdk_screen_get_default_colormap: assertion `GDK_IS_SCREEN (screen)' failed
(firefox-bin:14345): Gdk-CRITICAL **: IA__gdk_screen_get_root_window: assertion `GDK_IS_SCREEN (screen)' failed
(firefox-bin:14345): Gdk-CRITICAL **: IA__gdk_screen_get_root_window: assertion `GDK_IS_SCREEN (screen)' failed
(firefox-bin:14345): Gdk-CRITICAL **: IA__gdk_window_new: assertion `GDK_IS_WINDOW (parent)' failed
Segmentation fault

The current workaround is to remove oxygen-gtk from the system and use a different theme for applications.

ATI Catalyst driver creates glitches and artifacts

For the moment, Catalyst is not supposed to be used while running GNOME Shell. The open-source ATI driver, xf86-video-ati, however, seems to be working properly with the GNOME 3 composited desktop.

Note: Fix is promised with Catalyst 11.9. See

xf86-video-ati driver: flickers from time to time

If you use that driver, your desktop might flicker a lot when you hover the bottom right corner, and also when you start up gdm. Write the following in your /etc/X11/xorg.conf.d/20-radeon.conf and see if it works then:

Section "Device"
       Identifier "Radeon"
       Driver "radeon"
       Option "EnablePageFlip" "off"

xf86-video-intel driver "tears" regardless if VSYNC is enabled or not

Just stick the following into /etc/environment:


Refer to: for more details.

Window opens behind other windows when using multiple monitors

This is possibly a bug in GNOME Shell which causes new windows to open behind others. Unchecking "workspaces_only_on_primary" in desktop/gnome/shell/windows using gconf-editor solves this problem.

Multiple monitors and dock extension

If you have multiple monitors configured using Nvidia Twinview, the dock extension may get sandwiched in-between the monitors. You can edit the source of this extension to reposition the dock to a position of your choosing.

Edit /usr/share/gnome-shell/extensions/ and locate this line in the source:, (primary.height-height)/2);

The first parameter is the X position of the dock display, by subtracting 15 pixels as opposed to 2 pixels from this it correctly positioned on my primary monitor, you can play around with any X,Y coordinate pair to position it correctly., (primary.height-height)/2);

No event sounds for Empathy and other programs

If you are using OSS, you may want to install libcanberra-ossAUR from the AUR.

Editing hotkeys via can-change-accels fails

It is also possible to manually change the keys via an application's so-called accel map file. Where it is to be found is up to the application: For instance, Thunar's is at ~/.config/Thunar/accels.scm, whereas Nautilus's is located at ~/.gnome2/accels/nautilus. The file should contain a list of possible hotkeys, each unchanged line commented out with a leading ";" that has to be removed for a change to become active.

Panels do not respond to right-click in fallback mode

Check Configuration Editor: /apps/metacity/general/mouse_button_modifier. This modifier key (Template:Keypress, Template:Keypress, etc) used for normal windows is also used by panels and their applets.

"Show Desktop" keyboard shortcut does not work

GNOME developers treated the corresponding binding as bug (see due to Minimization being deprecated. To show the desktop again assign ALT+STRG+D to the following setting:

System Settings --> Keyboard --> Shortcuts --> Navigation --> Hide all normal windows

Nautilus does not start

  1. Press Template:Keypress
  2. Enter gnome-tweak-tool
  3. Select the File Manager tab.
  4. Locate option Have file manager handle the desktop and assure it is toggled off.

Epiphany does not play Flash videos

Adobe Flash Player is buggy and does not work directly in Epiphany. See Epiphany#Flash for a workaround involving nspluginwrapper.

Unable to apply stored configuration for monitors

If you encounter this message try to disable the xrandr gnome-settings-daemon plugin :

$ dconf write /org/gnome/settings-daemon/plugins/xrandr/active false

Lock button fails to re-enable touchpad

Some laptops have a touchpad lock button that disables the touchpad so that users can type without worrying about touching the touchpad. It appears currently that although GNOME can lock the touchpad by pressing this button, it cannot unlock it. If the touchpad gets locked you can do the following to unlock it.

  1. Start a terminal. You can do this by pressing Template:Keypress, then typing gnome-terminal followed by pressing Template:Keypress.
  2. Type in the following command
$ xinput set-prop "SynPS/2 Synaptics TouchPad" "Device Enabled" 1

Unable to connect to secured Wi-Fi networks

You can see the network connections listing, but choosing an encrypted network fails to show a dialog for key entry. You may need to install network-manager-applet. See GNOME NetworkManager setup.

"Any command has been defined 33"

When you press the Template:Keypress key (sometimes labeled Template:Keypress or Template:Keypress) to take a screenshot, and you got "Any command has been defined 33", install metacity.

GDM and GNOME use X11 cursors

To fix this issue, become root and put the following into /usr/share/icons/default/index.theme (creating the directory /usr/share/icons/default if necessary):

[Icon Theme]

Note: Instead of "Adwaita", you can choose another cursor theme (e.g. Human). Alternatively, you can install gnome-cursors-fixAUR from the AUR.

Tracker & Documents don't list any local files

In order for Tracker (and, therefore, Documents) to detect your local files, they must be stored in directories that it knows of. If your documents are contained in one of the usual XDG standard directories (i.e. "Documents" or "Music"), you should install xdg-user-dirs and run:

 # xdg-user-dirs-update

This will create all of the usual XDG home directories if they don't already exist and it will create the config file definining these directories that Tracker and Documents depend upon.

External links