Difference between revisions of "GNOME"

From ArchWiki
Jump to: navigation, search
(Removed several 'helper scripts' created to change background (Adding unnecessary bloat to the document). Mentioned the dconf-editor GUI as an easy way, and left the actual command-like equivalents as well.)
Line 340: Line 340:
 
{{cli|$ dbus-launch}}
 
{{cli|$ dbus-launch}}
  
The third command prints DBUS_SESSION_BUS_ADDRESS and DBUS_SESSION_BUS_PID. We must export these variables.
+
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_ADDRESS=unix:abstract=/tmp/dbus-Jb433gMQHS,guid=fc14d4bf3d000e38276a5a2200000d38
 
  $ export DBUS_SESSION_BUS_PID=4283
 
  $ export DBUS_SESSION_BUS_PID=4283
  
The following backtick-ed command combines '''dbus-launch''' and '''export''' into a single command. (Dbus-launch has command line options which appear to obviate the need for the '''sed''' pipeline; that method seems to export no more than the first variable.)
+
Or use the follow command:
  
 
  $ `dbus-launch | sed "s/^/export /"`
 
  $ `dbus-launch | sed "s/^/export /"`
  
<div style="margin: 1em 3em;">
 
To avoid copying and pasting, you may use the script '''{{Filename|prep-gdm-vars}}''' to export the variables. The other scripts assist in setting up the GDM wallpaper. Place these files in a suitable location. Make them executable using {{codeline|chmod}}. An example of running these scripts appears below.
 
 
{{File|name=/usr/local/bin/prep-gdm-vars|content=<nowiki>#  This script must be run using '.' or 'source'
 
`dbus-launch | sed "s/^/export /"`</nowiki>}}
 
 
{{File|name=/usr/local/bin/show-avail-gdm-bkgd|content=<nowiki>#!/bin/bash
 
#  Usage:  show-avail-gdm-bkgd  [folder]
 
#  Specify any folder within /usr/share/backgrounds.
 
#  If you omit the folder, you'll be shown available choices.
 
file_part="/usr/share/backgrounds/"
 
if ! [ $1 ]; then
 
  echo -en \\n  Please specify one of these directories:\\n\\n\\040
 
  ls $file_part; echo; exit 1; fi
 
ls ${file_part}/$1
 
</nowiki>}}
 
 
{{File|name=/usr/local/bin/revise-gdm-bkgd|content=<nowiki>#!/bin/bash
 
#  Usage:  revise-gdm-bkgd gnome/filename.jpg
 
#  Specify any file path within /usr/share/backgrounds.
 
org_part="org.gnome.desktop.background picture-uri"
 
file_full="/usr/share/backgrounds/$1"
 
# Trap when argument is: missing, a mere directory, a bad filename.
 
if ( ! [ $1 ] || [ -d $file_full ] ); then
 
  echo -en \\n Specify a file.  Use this example:
 
  echo -e \ \ revise-gdm-bkgd \ gnome/TwoWings.jpg\\n; exit 1; fi
 
if ! [ -r $file_full ]; then
 
  echo -e \\n Specifed file does not exist or is not readable.\\n; exit 2; fi
 
GSETTINGS_BACKEND=dconf gsettings set $org_part "file://${file_full}"
 
</nowiki>}}
 
</div>
 
  
 
Check to see if dconf-service is running and if not, start it like this
 
Check to see if dconf-service is running and if not, start it like this
Line 387: Line 356:
 
==== Login background image ====
 
==== 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 following commands retrieve or set the file name used for GDM's wallpaper.
+
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.
 
<pre style="overflow:auto;">
 
<pre style="overflow:auto;">
 
  $  GSETTINGS_BACKEND=dconf gsettings get org.gnome.desktop.background picture-uri
 
  $  GSETTINGS_BACKEND=dconf gsettings get org.gnome.desktop.background picture-uri
Line 394: Line 371:
 
  $  GSETTINGS_BACKEND=dconf gsettings set org.gnome.desktop.background picture-options 'zoom'
 
  $  GSETTINGS_BACKEND=dconf gsettings set org.gnome.desktop.background picture-options 'zoom'
 
  ## Possible values: centered, none, scaled, spanned, stretched, wallpaper, zoom</pre>
 
  ## Possible values: centered, none, scaled, spanned, stretched, wallpaper, zoom</pre>
You must specify a file which user "gdm" has permission to read. GDM cannot read files in your home directory.
+
Note: You must specify a file which user "gdm" has permission to read. GDM cannot read files in your home directory.
 
+
<div style="margin: 1em 3em;">
+
Here is a session showing how a user might change the GDM wallpaper using the scripts listed above. It starts with a normal user's terminal and assumes he is able to open a bash session as root. The root user then opens a session as "gdm" and changes the wallpaper.
+
 
+
$ su -
+
Password:
+
+
# xhost +
+
access control disabled, clients can connect from any host
+
# su - gdm -s /bin/bash
+
+
'''-bash-4.2$''' . prep-gdm-vars  #  Must use . to execute this script!
+
access control disabled, clients can connect from any host
+
+
'''-bash-4.2$''' show-avail-gdm-bkgd gnome
+
Aqua.jpg            FreshFlower.jpg  Spaceflare-nova.jpg      Terraform-green.jpg  YellowFlower.jpg
+
Blinds.jpg          Garden.jpg      Spaceflare-supernova.jpg  Terraform-orange.jpg
+
BlueMarbleWest.jpg  GreenMeadow.jpg  SundownDunes.jpg          TwoWings.jpg
+
FootFall.png        Spaceflare.jpg  Terraform-blue.jpg        Wood.jpg
+
+
'''-bash-4.2$''' revise-gdm-bkgd gnome/GreenMeadow.jpg
+
+
'''-bash-4.2$''' logout
+
+
# logout
+
$
+
 
+
Script '''{{Filename|revise-gdm-bkgd}}''' may also be used to change your normal user background from the command prompt. Admittedly, the script name does not quite fit when used for that purpose.
+
</div>
+
  
If you want a graphical interface to changing themes (gtk3, icons and cursor), the wallpaper and minor other settings of the GDM login screen, you can install [https://aur.archlinux.org/packages.php?ID=50232 gdm3setup] from AUR.
+
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 [https://aur.archlinux.org/packages.php?ID=50232 gdm3setup] from AUR.
  
 
==== Larger font for login ====
 
==== Larger font for login ====

Revision as of 05:52, 22 September 2011

This template has only maintenance purposes. For linking to local translations please use interlanguage links, see Help:i18n#Interlanguage links.


Local languages: Català – Dansk – English – Español – Esperanto – Hrvatski – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Norsk Bokmål – Polski – Português – Slovenský – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – العربية – ไทย – 日本語 – 正體中文 – 简体中文 – 한국어


External languages (all articles in these languages should be moved to the external wiki): Deutsch – Français – Română – Suomi – Svenska – Tiếng Việt – Türkçe – فارسی

Summary help replacing me
GNOME 3 provides a modern desktop, rewritten from scratch, using the GTK3+ toolkit.
Overview
Template:Graphical user interface overview
Related
GTK+

The GNOME Project started from scratch and created a completely new desktop called GNOME 3. It has:

  • A modern visual theme and font
  • An activities view providing access to all windows and applications
  • A subtle notifications system and a discrete top panel
  • Integration with an improved Nautilus file manager
  • Integrated desktop services for messaging
  • A new system settings application
  • An activities search feature
  • Features such as snap-like window tiling

Additional explanations are found on the official GNOME3 website.

Contents

Introduction

GNOME 3 has two interfaces: GNOME Shell, the new standard layout; and fallback mode.  Gnome-session automatically detects when your computer is incapable of running Gnome Shell and starts fallback mode when appropriate.

Fallback mode is similar to GNOME 2. (Fallback mode uses gnome-panel/Metacity instead of gnome-shell/Mutter.)

When you are on fallback mode you can still replace GNOME's default window manager with your preferred one.

Upgrade from GNOME 2

Warning: Upgrading to GNOME 3 from a GNOME 2 session might cause a system crash.

It is recommended that you run the update command from a TTY session or from another Desktop Environment / Window Manager.

Template:Cli

After this update you have installed GNOME 3.x with fallback mode only. To install the new GNOME shell:

Template:Cli

Depending on your setup, you might need to delete your old configuration to get a successful session start.

Template:Cli Template:Cli Template:Cli

Installation

GNOME 3 is in the [extra] repository. The gnome group contains the core desktop environment and applications, and gnome-extra contains the rest. You likely don't want all of the packages installed, so consider reading the package descriptions before installing them (or just remove them later).

Example:

Template:Cli Template:Cli

D-Bus daemon

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

Running GNOME

For the best desktop integration, login manager GDM is recommended. Other login managers (a.k.a. display managers) such as SLiM 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.

Template:Cli

If you prefer to start GNOME manually from the console, add the following line to your Template:Filename file. Make sure it is the only line (remove the Template:Codeline block from the standard Template:Filename since the Template:Codeline block can cause problems) and the only command starting with Template:Codeline. See the xinitrc wiki article. Template:File

After the Template:Codeline command is placed, GNOME can be launched by typing Template:Codeline.

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.

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.

Gsettings

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.

Template:Cli

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 Template:Filename  with GTK2+, it is possible to set a GTK3 theme via  Template:Filename.

Variable Template:Codeline is usually set to ~/.config

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

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

Icon theme

Using gnome-tweak-tool v. 3.0.3 and later, you can place any icon theme you wish to use inside  Template:Filename.

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

Template:Cli

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  Template:Filename.

Template:File

Nautilus

Remove folders from the places sidebar

The displayed folders are specified in Template:Filename and can be altered with any editor. An execution of Template:Codeline will change them again, thus it may be advisable to set the file permissions to read-only.

Always show text-entry location

The standard Nautilus toolbar shows a button bar interface for path navigation. To enter path locations using the keyboard you must expose the location text-entry field. This is done by pressing Template:Keypress + Template:Keypress

To make the location text-entry field always present, use gsettings as shown. Template:Cli

Note: after changing this setting you will not be able to expose the button bar. Only when the setting is false can both forms of location navigation be employed.

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.

Template:Cli

Hide accessibility icon

Create a folder named  Template:Filename  in  Template:Filename. Create two new files:

Template:File
Template:File

Restart the GNOME shell. The accessibility icon should be hidden. If this extension ceases to work in the future, adjust the shell version number in Template:Filename

Alternatively, you may disable the accessibility icon system-wide. Edit Template:Filename  Locate the following line and comment it out or delete it. Afterward restart the shell. Template:File

Hide bluetooth icon

Deactivate bluetooth as startup-service if that is your intent. Refer to section Automatic program launch upon login

Create a folder named Template:Filename  in  Template:Filename. Create two new files:

Template:File
Template:File

Restart the GNOME shell. The icon should be hidden. If this extension ceases to work in the future, adjust the shell version number in Template:Filename

Show battery icon

To show the battery tray icon, install Template:Codeline.

Template:Cli

Disable "Suspend" in the status menu

A quick way to do it system-wide is to change line 153 of Template:Filename.  This change takes effect the next time GNOME Shell is started. Template:File

However, the effect won't last after a GNOME update. A more perennial solution is to install the alternative status menu.

Template:Cli

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.

Template:Cli

Show system monitor

Install the gnome-shell-system-monitor-applet-git extension available in the 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 Template:Filename.  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.

Template:Cli Template:Cli

For system wide changes, edit files in Template:Filename.  For local changes, make a copy of foo.desktop  in your home folder.

Template:Cli

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  Template:Filename

For user themes, edit Template:Filename

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

A cloned GNOME Shell theme with smaller icons is available on the AUR.

Titlebar

Reduce titlebar height

# sed -i '/title_vertical_pad/s|value="[0-9]\{1,2\}"|value="0"|g' /usr/share/themes/Adwaita/metacity-1/metacity-theme-3.xml

Restart the GNOME shell. This changes vertical padding from 14 to 0, giving windows a sleeker look.

To restore the original values:

Template:Cli

Reorder titlebar buttons

At present this setting is changeable only through gconf-editor.

For example, we move the close and minimize buttons to the left side of the titlebar. Open gconf-editor and locate the desktop.gnome.shell.windows.button_layout  key. Change its value to Template:Codeline  (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:KeypressTemplate:Keypress + Template:Keypress  or  Template:Keypress + Template:Keypress  to remedy the situation.

To prevent Template:Filename from being overwritten each time package "gnome-themes-standard" is upgraded, add its name to Template:Filename with Template:Codeline.

Template:File

To restore original Adwaita theme values:

Template:Cli

Login screen

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

Template:Cli Template:Cli Template:Cli

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

Template:Cli

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 gdm3setup 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

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 login

Specify which programs start automatically after login using Template:Codeline. This tool is part of the Template:Codeline package.

Template:Cli

Activate numlock upon login

Install numlockx from repository [community]. Then, add a startup command to launch numlockx.

Template:Cli Template:Cli

The above command opens the Startup Applications Preferences applet. Click Add  and enter the following:

Name: Numlockx
Command:   /usr/bin/numlockx on
Comment: Turns on numlock.

This is not a system-wide appearance tweak. Repeat these steps for each user wishing to activate numlock upon login.

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. Details on available extensions are found at the WEBUPD8 site. The most recent articles can be found using this WEBUPD8 search link.

Repository [extras] has a dozen extensions which can be installed individually. (The latest version of a given extension may be installed using its code snapshot, if preferred.)  List here.

Template:Cli

Other useful extensions provided in the AUR:

 Presentation Mode Adds option to inhibit screensaver in the power menu (battery icon).
 Weather Displays weather notifications.
 Alternative Status Menu     Adds "Hibernate" and "Power Off" to the status menu.
Theme selector Select a theme in the activities overview. To install a custom theme with Gnome Tweak Tool you need to install the User theme extension

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

Default terminal

Template:Codeline, which replaces Template:Codeline in GNOME 3, is used to set e. g. the default terminal manually. The setting is relevant for nautilus-open-terminal. The commands for urxvt run as daemon:

gsettings set org.gnome.desktop.default-applications.terminal exec urxvtc
gsettings set org.gnome.desktop.default-applications.terminal exec-arg "'-e'"
Note: For nautilus-open-terminal, you may need a flag (e.g. Template:Codeline) to indicate that a command will follow: nautilus-open-terminal passes a Template:Codeline command in order to change directories to the appropriate location.

Middle mouse button

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

Template:Cli

Xmonad

Xmonad is a tiling window manager.

Upgrading to GNOME 3 will likely break your xmonad setup. You can use xmonad again by forcing fallback mode and creating two files:

Template:File
Template:File

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

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  Template:Codeline  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 + 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 Template:Codeline to prevent accidental hotkey changes.

Shutdown via the status menu

Presently, 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 Alt 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:

Template:Cli

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 Freedesktop.org Telepathy Wiki.

Enabling 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 Template:Codeline

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

Template:Cli

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

Troubleshooting

GNOME login takes a very long time

See if you enabled PulseAudio Network settings in paprefs. When any network audio settings are enabled, GNOME hangs about a minute after login.

One solution is to create a new user account and login to that account. Another solution is to move your ~/.gconf, ~/.gconfd and ~/.conf/dconf folders to a holding area. Login again to see if the delay is gone.

If the excessive delay is gone, determine which setting causes the delay using trial-and-error.

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  Template:Filename Template:Filename or Template:Filename. 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 don't work after GNOME 3 update

Locate the folder where your extensions are installed. It might be Template:Filename or Template:Filename.

Edit each occurrence of  Template:Filename  which appears in each extension sub-folder.

Insert: Template:Codeline
Instead of (for example):   Template:Codeline
You might instead use: Template:Codeline


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

Screen is not locked after resume

Screen lock only works when you suspend through GNOME's status menu. If you suspend or hibernate using the power button, your screen is not locked after resume. The problem is a configuration failure in dconf.

Open dconf-editor and uncheck  Template:Codeline  in the key named  org.gnome.power-manager.

Template:Cli

Your screen should now be locked after resume whether you used the status menu, the power button, or a key combination. Bug report: Screen gets no more locked after suspend #Comment 8

GTK2+ apps show segfaults and fail to launch

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 proposed to be used while running GNOME Shell. The opensource 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 http://ati.cchtml.com/show_bug.cgi?id=99

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/dock@gnome-shell-extensions.gnome.org/extension.js and locate this line in the source:

this.actor.set_position(primary.width-this._item_size-this._spacing-2, (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.

this.actor.set_position(primary.width-this._item_size-this._spacing-15, (primary.height-height)/2);

No event sounds for Empathy and other programs

If you're using OSS, you may want to install libcanberra-oss from 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 Template:Filename, whereas Nautilus's is located at Template:Filename. 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 don't respond to right-click in fallback mode

Check Configuration Editor: /apps/metacity/general/mouse_button_modifier. This modifier key (<Alt>, <Super>, 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 https://bugzilla.gnome.org/show_bug.cgi?id=643609) due to Minimization being deprecated. To show the desktop again assign ALT+STRG+D to the following setting:

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

Nautilus does not start

  1. Press Template:Keypress+Template:Keypress
  2. Enter Template:Codeline
  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

Epiphany now uses gtk3, but Adobe's Flash Player still relies on gtk2. 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 :

Template:Cli

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 can't 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+Template:Keypress , then typing Template:Codeline and then pressing Template:Keypress
  2. Type in the following command

Template:Cli

Ctrl+V pastes path instead of file in Nautilus

If you are affected by this issue, edit Template:Filename where you can find two lines for Ctrl+V : Template:File

The issue appears to stem from the second entry. Deleting that line may fix the issue temporarily. You might have to reapply this fix after an update.

An alternative is to assign a different key combination to one of the actions.

Unable to connect to secured wi-fi network

You 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 print screen key to take screenshot and you got "Any command has been defined 33", install metacity:

Template:Cli

External links