Difference between revisions of "Cursor themes"

From ArchWiki
Jump to: navigation, search
(new templates, see Help:Style)
Line 13: Line 13:
 
  pacman -S xcursor-vanilla-dmz  #white
 
  pacman -S xcursor-vanilla-dmz  #white
 
  pacman -S xcursor-vanilla-dmz-aa  #black
 
  pacman -S xcursor-vanilla-dmz-aa  #black
{{Note| The {{Package Official|xcursor-themes}} package (installed by default with the {{Package Official|xorg}} group) already comes with the 'redglass' and 'whiteglass' themes in {{Filename|/usr/share/icons}}.}}
+
{{Note| The {{Pkg|xcursor-themes}} package (installed by default with the {{Pkg|xorg}} group) already comes with the 'redglass' and 'whiteglass' themes in {{ic|/usr/share/icons}}.}}
  
 
Some themes available through [http://aur.archlinux.org/packages.php?O=0&L=0&C=17&K=cursor&SeB=nd&SB=n&SO=a&PP=50&do_Search=Go AUR].
 
Some themes available through [http://aur.archlinux.org/packages.php?O=0&L=0&C=17&K=cursor&SeB=nd&SB=n&SO=a&PP=50&do_Search=Go AUR].
Line 80: Line 80:
 
  $ ln -s left_ptr_watch 08e8e1c95fe2fc01f976f1e063a24ccd
 
  $ ln -s left_ptr_watch 08e8e1c95fe2fc01f976f1e063a24ccd
  
If the above links do not 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.
  
 
== Choosing and Configuring Cursor Themes ==
 
== Choosing and Configuring Cursor Themes ==
Line 86: Line 86:
 
If you use some desktop environment like Gnome, you can use its GUIs to choose cursor themes.
 
If you use some desktop environment like Gnome, you can use its GUIs to choose cursor themes.
  
To locally name a cursor theme, add to your {{Filename|~/.Xresources}}:
+
To locally name a cursor theme, add to your {{ic|~/.Xresources}}:
  
 
  Xcursor.theme: foobar
 
  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 {{Filename|~/.xinitrc}} or [[.xprofile]] (depending on your setup):
+
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 &
 
  xrdb ~/.Xresources &
Line 96: Line 96:
 
Refer to your window manager documentation for details.
 
Refer to your window manager documentation for details.
  
Alternatively, you can create a symlink "default" in {{Filename|~/.icons}}, which points to your installed cursor theme:
+
Alternatively, 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:
+
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
  
Line 124: Line 124:
 
  $ 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:}}
+
{{Note| If the animations are flickering on your nvidia card, add the following line to your {{ic|/etc/X11/xorg.conf}} file, into the nvidia device section, to fix it:}}
 
  Option "HWCursor" "off"
 
  Option "HWCursor" "off"

Revision as of 18:08, 6 November 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 – فارسی

There are many cursor themes available for the X11 Windowing System besides the default black pointer. This guide will instruct you on where to get them, installing them, and configuring them.

Getting Mouse Cursor Themes

First, check which themes you already have installed:

ls /usr/share/icons/*

Search for directories with the cursors subdirectory.

Also, check the official Arch repositories for cursor themes: search "xcursor-". One particularly popular with many distributions theme is xcursor-vanilla-dmz (white) with its black version xcursor-vanilla-dmz-aa. Use one or both of these commands to install them:

pacman -S xcursor-vanilla-dmz  #white
pacman -S xcursor-vanilla-dmz-aa  #black
Note: The xcursor-themes package (installed by default with the xorg group) already comes with the 'redglass' and 'whiteglass' themes in /usr/share/icons.

Some themes available through AUR.

Here are links to where else you may download cursor:

Installing Mouse Cursor Themes

This manual installation method is only required if you are not using pacman to install themes like described above.

Extract the cursor theme package:

$ tar -zxvf foobar-cursor-theme-package-foo.tar.gz

or

$ tar -jxvf foobar-cursor-theme-package-foo.tar.bz2

Make a directory for the cursor theme:

Example: FooBar-AweSoMe-Cursors-v2.98beta

User-specific installation:

$ mkdir -p ~/.icons/foobar/cursors

System-wide installation:

# mkdir -p /usr/share/icons/foobar/cursors
Note: To simplify the name of the theme, the name being used is 'foobar' instead of 'FooBar-AweSoMe-Cursors-v2.98beta' when creating the dir(s) above.

Copy cursor files into the appropriate directory:

User-specific installation:

$ cp -a FooBar-AweSoMe-Cursors-v2.98beta/cursors/* ~/.icons/foobar/cursors/

System-wide installation:

# cp -a FooBar-AweSoMe-Cursors-v2.98beta/cursors/* /usr/share/icons/foobar/cursors/

If the package includes index.theme file check if there is an "Inherits" line inside. If yes, check whether the inherited theme also exists under this name in your system (rename if needed).

Copy index.theme file into the appropriate directory:

User-specific installation:

$ cp -a FooBar-AweSoMe-Cursors-v2.98beta/index.theme ~/.icons/foobar/index.theme

System-wide installation:

# cp -a FooBar-AweSoMe-Cursors-v2.98beta/index.theme /usr/share/icons/foobar/index.theme

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:

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:

$ cd ~/.icons/foobar/cursors/
$ ln -s right_ptr arrow
$ ln -s cross crosshair
$ ln -s right_ptr draft_large
$ ln -s right_ptr draft_small
$ ln -s cross plus
$ ln -s left_ptr top_left_arrow
$ ln -s cross tcross
$ ln -s hand hand1
$ ln -s hand hand2
$ ln -s left_side left_tee
$ ln -s left_ptr ul_angle
$ ln -s left_ptr ur_angle
$ ln -s left_ptr_watch 08e8e1c95fe2fc01f976f1e063a24ccd

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

Choosing and Configuring Cursor Themes

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

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 &

Refer to your window manager documentation for details.

Alternatively, 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.

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.

More information

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

$ man Xcursor
Note: If the animations are flickering on your nvidia card, add the following line to your /etc/X11/xorg.conf file, into the nvidia device section, to fix it:
Option "HWCursor" "off"