<?xml version="1.0" ?>
<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN"
"dtd/kdedbx45.dtd" [
<!ENTITY % addindex "IGNORE">
<!ENTITY % English "INCLUDE" > <!-- change language only here -->
]>

<article id="cursortheme" lang="&language;">
<articleinfo>
<title>Cursor Theme</title>
<authorgroup>
<author>&Mike.McBride; &Mike.McBride.mail;</author>
<author>&Brad.Hards; &Brad.Hards.mail;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

<date>2021-04-07</date>
<releaseinfo>Plasma 5.20</releaseinfo>

<abstract>
<para>This is the documentation for the &systemsettings; module to 
customize the mouse cursor appearance.
</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>Systemsettings</keyword>
<keyword>mouse</keyword>
<keyword>cursor</keyword>
</keywordset>
</articleinfo>

<para>
This module allows you to select from several installed cursor themes
from a preview of the cursor display.
</para>

<para>The features provided by this module may not be available on some systems. 
Your system may need to be updated to support cursor themes.
</para>

<para>
If you have additional cursor themes available, you can remove them using the trash button that appears when you hover the mouse pointer over the theme item in the list. Note that you cannot remove the default themes.
</para>

<para>Some themes allow choosing the cursor size. Use the <guilabel>Size</guilabel> field to select the appropriate size. Available sizes are displayed when you hoover the theme item in the list box with the mouse pointer.
</para>

<para>
If you have additional cursor themes available, you can install them using the <guibutton>Install from File...</guibutton> button below the list box. See <ulink url="https://userbase.kde.org/Special:MyLanguage/Create_your_own_mouse_cursor_theme">these instructions</ulink> on the details on how to create the custom cursor theme.
</para>

<para>Use the <guibutton>Get New Cursors...</guibutton> button to launch the <guilabel>Download New Cursors</guilabel> dialog and download additional themes from the Internet.</para>

</article>
