If the package doesn't have index.theme or if it doesn't include an "Inherits" line you don't have to copy this file.

+

If the package does not have index.theme or if it does not include an "Inherits" line, you do not have to copy this file.

'''Create links to missing cursors:'''

'''Create links to missing cursors:'''

−

Applications may keep using the default X11 cursors when a theme lacks some cursors. If you experience this, it can be corrected by adding links to the missing cursors. For example:

+

Applications may keep using the default cursors when a theme lacks some cursors. If you experience this, it can be corrected by adding links to the missing cursors. For example:

$ cd ~/.icons/foobar/cursors/

$ cd ~/.icons/foobar/cursors/

Line 73:

Line 83:

$ ln -s left_ptr_watch 08e8e1c95fe2fc01f976f1e063a24ccd

$ ln -s left_ptr_watch 08e8e1c95fe2fc01f976f1e063a24ccd

−

If the above links don't resolve the problem, look in {{Filename|/usr/share/icons/whiteglass/cursors}} for additional cursors your theme may be missing, and create links for them as well.

+

If the above links do not resolve the problem, look in {{ic|/usr/share/icons/whiteglass/cursors}} for additional cursors your theme may be missing, and create links for them as well.

−

== Configuring Cursor Themes ==

+

== Note on Cursor Themes not Working with Awesome Window Manager ==

−

To locally name a cursor theme, add to your {{Filename|~/.Xresources}}:

+

Xcursor does not work correctly with Awesome Window Manager. You may notice all of the themed cursors work except the default cursor.

−

Xcursor.theme: foobar

+

For more information see this link http://awesome.naquadah.org/wiki/FAQ#How_to_change_the_cursor_theme.3F

+

+

== Choosing and Configuring Cursor Themes ==

−

To have the cursor theme properly loaded it will need to be called by your window manager. If it does not, you can force it to load prior your window manager by putting the following command in {{Filename|~/.xinitrc}} or [[.xprofile]] (depending on your setup):

+

If you use some desktop environment like Gnome, you can use its GUIs to choose cursor themes.

−

xrdb ~/.Xresources &

+

=== Using the XDG Icon Theme Specification ===

−

Refer to your window manager documentation for details.

+

{{Note|This method will also set both the [[X11]] and [[Wayland]] cursor theme.}}

−

Alternatively, you can create a symlink "default" in {{Filename|~/.icons}}, which points to your installed cursor theme:

+

You can create a symlink "default" in {{ic|~/.icons}}, which points to your installed cursor theme:

$ ln -s /usr/share/icons/foobar/ ~/.icons/default

$ ln -s /usr/share/icons/foobar/ ~/.icons/default

−

If you rather want to change the cursor globally (e.g. used by graphical login managers like kdm, gdm, ...), or if you experience problems with above method (for example in Firefox), create the {{Filename|/usr/share/icons/default/}} directory '''(only if needed)''':

+

If you rather want to change the cursor globally (e.g. used by graphical login managers like kdm, gdm, ...), or if you experience problems with above method (for example in Firefox), create the {{ic|/usr/share/icons/default/}} directory '''(only if needed)''':

# mkdir -p /usr/share/icons/default '''(only if needed)'''

# mkdir -p /usr/share/icons/default '''(only if needed)'''

−

Edit or create the {{Filename|/usr/share/icons/default/index.theme}} file and add the following:

+

Edit or create the {{ic|/usr/share/icons/default/index.theme}} file and add the following:

−

[icon theme]

+

[icon theme]

Inherits=foobar

Inherits=foobar

−

Or if you have/want your cursor themes in {{Filename|~/.icons}} only. Create the {{Filename|~/.icons/default/}} directory:

+

Or if you have/want your cursor themes in {{ic|~/.icons}} only. Create the {{ic|~/.icons/default/}} directory:

$ mkdir -p ~/.icons/default

$ mkdir -p ~/.icons/default

−

And create the {{Filename|~/.icons/default/index.theme}} file with the same contents as above {{Filename|/usr/share/icons/default/index.theme}}.

+

And create the {{ic|~/.icons/default/index.theme}} file with the same contents as above {{ic|/usr/share/icons/default/index.theme}}.

−

You can optionally add this line to {{Filename|~/Xresources}} if your cursor theme supports multiple sizes:

+

=== With Gnome 3.8 ===

+

+

To change the cursor theme with Gnome 3.8, run the following command:

+

+

gsettings set org.gnome.desktop.interface cursor-theme foobar

+

+

Or alternatively, use the dconf-editor to change the given key manually to the name of the theme.

+

+

That will change the theme of the user, but not the one used in GDM. To change the cursor theme in the greeter create the file {{ic|/etc/dconf/db/gdm.d/10-cursor-settings}} with content:

+

+

[org/gnome/desktop/interface]

+

cursor-theme='foobar'

+

+

And run as root the following command:

+

+

dconf update

+

+

=== Using X resources ===

+

+

To locally name a cursor theme, add to your {{ic|~/.Xresources}}:

+

+

Xcursor.theme: foobar

+

+

To have the cursor theme properly loaded it will need to be called by your window manager. If it does not, you can force it to load prior your window manager by putting the following command in {{ic|~/.xinitrc}} or [[.xprofile]] (depending on your setup):

+

+

xrdb ~/.Xresources &

+

+

You can optionally add this line to {{ic|~/.Xresources}} if your cursor theme supports multiple sizes:

Xcursor.size: 16 ! 32, 48 or 64 may also be good values

Xcursor.size: 16 ! 32, 48 or 64 may also be good values

−

If you don't know about supported cursor sizes just start X without this setting and let it choose the cursor size automatically.

+

If you do not know about supported cursor sizes just start X without this setting and let it choose the cursor size automatically.

+

+

Refer to your window manager documentation for details.

== More information ==

== More information ==

For more information about cursors in X (supported directories, formats, compatibility, etc.) refer to the man page:

For more information about cursors in X (supported directories, formats, compatibility, etc.) refer to the man page:

$ man Xcursor

$ man Xcursor

−

−

{{Note| If the animations are flickering on your nvidia card, add the following line to your {{Filename|/etc/X11/xorg.conf}} file, into the nvidia device section, to fix it:}}

−

Option "HWCursor" "off"

Revision as of 19:52, 23 April 2013

zh-CN:X11 Cursors
There are many cursor themes available besides the default black pointer.
This guide will instruct you on where to get them, installing them, and configuring them.

Choosing and Configuring Cursor Themes

If you use some desktop environment like Gnome, you can use its GUIs to choose cursor themes.

Using the XDG Icon Theme Specification

Note: This method will also set both the X11 and Wayland cursor theme.

You can create a symlink "default" in ~/.icons, which points to your installed cursor theme:

$ ln -s /usr/share/icons/foobar/ ~/.icons/default

If you rather want to change the cursor globally (e.g. used by graphical login managers like kdm, gdm, ...), or if you experience problems with above method (for example in Firefox), create the /usr/share/icons/default/ directory (only if needed):

# mkdir -p /usr/share/icons/default (only if needed)

Edit or create the /usr/share/icons/default/index.theme file and add the following:

[icon theme]
Inherits=foobar

Or if you have/want your cursor themes in ~/.icons only. Create the ~/.icons/default/ directory:

$ mkdir -p ~/.icons/default

And create the ~/.icons/default/index.theme file with the same contents as above /usr/share/icons/default/index.theme.

With Gnome 3.8

To change the cursor theme with Gnome 3.8, run the following command:

gsettings set org.gnome.desktop.interface cursor-theme foobar

Or alternatively, use the dconf-editor to change the given key manually to the name of the theme.

That will change the theme of the user, but not the one used in GDM. To change the cursor theme in the greeter create the file /etc/dconf/db/gdm.d/10-cursor-settings with content:

[org/gnome/desktop/interface]
cursor-theme='foobar'

And run as root the following command:

dconf update

Using X resources

To locally name a cursor theme, add to your ~/.Xresources:

Xcursor.theme: foobar

To have the cursor theme properly loaded it will need to be called by your window manager. If it does not, you can force it to load prior your window manager by putting the following command in ~/.xinitrc or .xprofile (depending on your setup):

xrdb ~/.Xresources &

You can optionally add this line to ~/.Xresources if your cursor theme supports multiple sizes:

Xcursor.size: 16 ! 32, 48 or 64 may also be good values

If you do not know about supported cursor sizes just start X without this setting and let it choose the cursor size automatically.

Refer to your window manager documentation for details.

More information

For more information about cursors in X (supported directories, formats, compatibility, etc.) refer to the man page: