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

<article id="screensaver" lang="&language;">
<articleinfo>
<title>Screen Saver</title>
<authorgroup>
<author>&Mike.McBride; &Mike.McBride.mail;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

<date>2010-09-25</date>
<releaseinfo>&kde; 4.5</releaseinfo>

<keywordset>
<keyword>KDE</keyword>
<keyword>systemsettings</keyword>
<keyword>screensaver</keyword>
<keyword>screen saver</keyword>
</keywordset>
</articleinfo>

<sect1 id="kcm_screensaver">

<title>Screen Saver</title>

<para>Using this module, you can choose your screen saver, determine
how much time must pass before the screen saver is activated, and add
or remove password protection to your screen saver.</para>

<sect2 id="ss-choose">
<title>Choosing the screen saver, and configuring its options</title>

<para>Along the left side is a list of all available screen savers.  You can
select a screen saver by simply clicking on its name.  Once
you have selected a screen saver, you will see a small preview on the 
monitor on the right.</para>

<note><para>The preview monitor will often show the screen saver
larger than it is when the screen saver is activated.  This is done on
purpose, since many of the details of the screen savers would be
unintelligible if actually scaled down to such a small
size.</para></note>

<para>Each screen saver has a different set of setup options.  By
clicking on <guilabel>Setup...</guilabel>, a dialog box will appear with
all available options.  As you adjust the options, the preview box in
the dialog box will show you what effect you will achieve with the
current settings.</para>

<para>When you are done setting up your screen saver, click
<guibutton>OK</guibutton>.</para> <para>Clicking <guibutton>Cancel</guibutton>
will erase any changes you made in this dialog box, and return you to the
screen saver module.</para>

<para>For most screen savers a description, Copyright and Author information
is shown directly in the dialog, for others you need to click the 
<guibutton>About</guibutton> button to read this information.</para>

<para>When you think you have all the options set the way you want,
simply click on <guibutton>Test</guibutton> to immediately start the
screen saver <emphasis>exactly</emphasis> as it will appear.</para>

</sect2>

<sect2 id="ss-options">
<title>Setting the time, priority and passwords for screen
savers.</title>

<para>Below the screensaver list is a check box to have the screen saver <guilabel>Start automatically after</guilabel>, and a spin box which determines the period of inactivity before the screen saver should be started.  You can enter any positive number of minutes in this box.</para>

<para>Below that is a check box labeled <guilabel>Require password 
after</guilabel>.  If it is checked, when you click a key
or click a mouse button to end the screen saver after the time in the spinbox and return to your
work, you must enter a password.  The password used is the same
password you used to login to your machine.  If there is no mark in
the check box, no password is required to return to your
desktop.</para>

<para>If you would like to have some interactive widgets like notes or a player 
on the locked screen saver, enable <guilabel>Allow widgets on screen saver</guilabel> 
and click the <guibutton>Configure Widgets...</guibutton> button to select your 
favorite widgets.
</para>

</sect2>

<sect2 id="ss-other"><title>Using a non-&kde; screen saver</title> 

<para>&kde; does not prevent another screen saver from working.  To use a
different screen saver, such as <application>xscreensaver</application>, simply
disable the &kde; Screen Saver, and set up your other screen saver program
normally.  </para>

</sect2>

<sect2 id="screensaver-remove">
<title>Removing and restoring a screen saver from your system</title>

<para>If you want to remove a screen saver from the list in this
&systemsettings; module, you will need to rename a file on your
system.</para>

<caution><para>Working as a <systemitem
class="username">root</systemitem> user is a potentially dangerous
situation.  While unlikely, it is entirely possible to do permanent
damage to your system while working as
<emphasis>root</emphasis>.</para>

<para>Be very careful following the next set of
directions</para></caution>

<para>To delete a screen saver, type the following commands:</para>

<screen>
<prompt>bash$</prompt> <command>cd 
$KDEDIR/kde4/services/ScreenSavers</command>
<prompt>bash$</prompt> <command>ls</command>
</screen> 

<para>This will give you a list of files.  You will notice
similarities between some of the file names and that of the screen saver you
want to remove.  Simply rename the file of similarly named desktop
file to a name which does not end in
<emphasis>desktop</emphasis>.</para>

<para>Example:</para>
<screen>
<prompt>bash$</prompt> <command>cd 
$KDEDIR/share/kde4/services/ScreenSavers</command>
<prompt>bash$</prompt> <command>mv krandom.desktop krandom.backup</command>
</screen> 

<para>Will remove the <quote>Random</quote> screen saver from the list</para>

<note><para>You must close the &systemsettings; entirely and restart it before 
the changes will be seen.</para></note>

<para>To restore the disabled screen saver, simply rename the file back to its 
original name:</para>

<screen>
<prompt>bash$</prompt> <command>cd 
$KDEDIR/share/kde4/services/ScreenSavers</command>
<prompt>bash$</prompt> <command>mv krandom.backup krandom.desktop</command>
</screen> 

<para>Restart the &systemsettings;, and the screen saver is back in the 
list.</para>

</sect2>

<sect2 id="grace">
<title>Advanced Settings: Grace period</title>

<para>There is a five second grace period after the screen saver
begins before a  password is required even if <guilabel>Require
password</guilabel> is checked.</para>
<para>Locking the desktop manually, by clicking the lock icon
in the &kde; panel, causes the password protection to engage immediately with
no grace period.</para>
<para>To alter the grace period setting, you need to manually edit the 
configuration file.  To do so:</para>
<para>
<prompt>$</prompt> <command>cd <filename>~/.kde/share/config</filename>
</command>
</para>
<para>Now, using a text editor (the example uses &kate;, the &kde; text editor), 
load the <filename>kscreensaverrc</filename>.</para>
<para>
<prompt>$</prompt> <command>kate <filename>kscreensaverrc</filename>
</command>
</para>
<para>Search through the file for an entry entitled 
<emphasis>LockGrace</emphasis>.</para>
<para>If the entry exists, you can edit the value of the entry.  </para>
<screen>LockGrace=3000</screen>
<para>The value of the entity represents the duration of the grace period
in milliseconds. An entry of 3000, would change the grace period to 3 seconds.
You can set the value of the entry to any number between zero (no grace period) 
and 300000 (5 minutes).
</para>
<para>If the entry does not exist, simply add the entry to the end of the 
section.</para>

<para>Any changes to the configuration entry take effect
immediately.</para>

</sect2>

</sect1>

</article>
