Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
apps:screensaver:start [2019/08/04 23:58] – updated with usage, prefs, and locker information kevinbowenapps:screensaver:start [2021/02/09 15:46] (current) – kevinbowen
Line 1: Line 1:
 ~~NOTOC~~ ~~NOTOC~~
 +{{ :xfce:xfce.ScreenSaver.png?no link|}}
 +====== xfce4-screensaver - Xfce Screensaver ======
 +  * **[[#Usage|Usage]]**
 +  * **[[:apps:xfce4-screensaver:installation|Building & Installation]]** -- Instructions for building and installing the screensaver.
 +  * **[[:apps:xfce4-screensaver:dbus|DBUS Interface]]** -- Interacting with the screensaver via DBUS.
 +  * **[[:apps:xfce4-screensaver:faq|Frequently Asked Questions]]** -- Diagnose and resolve configuration issues.
 +  * **[[#Known Issues|Known Issues]]**
 +  * **[[#Installation|Installation]]**
 +  * **[[#Latest Release|Latest Release]]**
 +  * **[[#Source Code Repository|Source Code Repository]]**
 +  * **[[#Reporting Bugs|Reporting Bugs]]**
  
-{{ :apps:screensaver:preferences-desktop-screensaver.png?nolink|}} +----
-====== Xfce Screensaver ====== +
-  * **[[https://git.xfce.org/apps/xfce4-screensaver/|Source Code]]** +
-  * **[[https://archive.xfce.org/src/apps/xfce4-screensaver/|Releases]]** +
-  * **[[https://bugzilla.xfce.org/buglist.cgi?component=General&product=Xfce4-screensaver|Bugs]]** +
  
 ===== Introduction ===== ===== Introduction =====
Line 13: Line 19:
 This project is a port of [[https://github.com/mate-desktop/mate-screensaver|MATE Screensaver]], itself a port of [[https://gitlab.gnome.org/Archive/gnome-screensaver|GNOME Screensaver]].\\ This project is a port of [[https://github.com/mate-desktop/mate-screensaver|MATE Screensaver]], itself a port of [[https://gitlab.gnome.org/Archive/gnome-screensaver|GNOME Screensaver]].\\
 It has been tightly integrated with the Xfce desktop, utilizing Xfce libraries and the Xfconf configuration backend. It has been tightly integrated with the Xfce desktop, utilizing Xfce libraries and the Xfconf configuration backend.
 +
 +----
  
 ==== Features ==== ==== Features ====
-  * Integration with the Xfce desktop +  * Integration with the Xfce desktop per-monitor wallpaper 
-  * Support for the xdg-screensaver standard+  * Locking down of configuration settings via Xfconf 
 +  * Support for XScreensaver screensavers
   * (optional) Integration with ConsoleKit and Systemd   * (optional) Integration with ConsoleKit and Systemd
   * DBUS interface for limited control and querying screensaver status   * DBUS interface for limited control and querying screensaver status
   * Idle time and inhibition state are based on the X11 Screensaver extension   * Idle time and inhibition state are based on the X11 Screensaver extension
 +  * Shared styles with LightDM GTK+ Greeter
   * No GNOME or MATE dependencies. Requirements are lightweight and shared with Xfce.   * No GNOME or MATE dependencies. Requirements are lightweight and shared with Xfce.
 +  * Full translation support into many languages
 +  * User switching
  
-==== Documentation ==== +----
- +
-  * **[[installation|Building & Installation]]** -- Instructions for building and installing the screensaver. +
- +
-  * **[[dbus|DBUS Interface]]** -- Interacting with the screensaver via DBUS. +
- +
-  * **[[faq|Frequently Asked Questions]]** -- Diagnose and resolve configuration issues.+
  
 ===== Usage ===== ===== Usage =====
 The application combines two functions: a **screensaver** that blanks the screen or fills it with images when the computer is idle; a **locker** that provides session security.  The application combines two functions: a **screensaver** that blanks the screen or fills it with images when the computer is idle; a **locker** that provides session security. 
  
-<figure "Screensaver preferences">{{:apps:screensaver:screensaver-prefs.png?nolink&|}}</figure>+<figure "Screensaver preferences">{{:apps:screensaver:screensaver-prefs.png?610x635|}}</figure> 
 + 
 +----
  
 ==== Enable Screensaver ====  ==== Enable Screensaver ==== 
         * This is the master switch for the screensaver. Note that the screensaver will not actually run unless activation has been enabled at the bottom of the tab.         * This is the master switch for the screensaver. Note that the screensaver will not actually run unless activation has been enabled at the bottom of the tab.
 +
 +----
 +
 ==== Theme ==== ==== Theme ====
         * The middle box consists of two parts: a list panel on the left and a small preview screen.         * The middle box consists of two parts: a list panel on the left and a small preview screen.
Line 43: Line 54:
         * Only a small number of themes are available by default. But Xfce Screensaver uses [[https://www.jwz.org/xscreensaver/|Xscreensaver]]-compatible screensavers, and collections of such screensavers (xscreensaver-data, xscreensaver-gl, etc.) can usually be installed separately from the main Xscreensaver package.          * Only a small number of themes are available by default. But Xfce Screensaver uses [[https://www.jwz.org/xscreensaver/|Xscreensaver]]-compatible screensavers, and collections of such screensavers (xscreensaver-data, xscreensaver-gl, etc.) can usually be installed separately from the main Xscreensaver package. 
         * For troubleshooting information about themes, consult the FAQs.         * For troubleshooting information about themes, consult the FAQs.
 +
 +----
  
 ==== Activate screensaver ==== ==== Activate screensaver ====
Line 48: Line 61:
         * Use the counter below the slider to set the time interval after the last screen activity before the computer is considered “idle.”         * Use the counter below the slider to set the time interval after the last screen activity before the computer is considered “idle.”
  
-<figure "Lock Screen (Locker)">{{:apps:screensaver:screensaver-locker.png?nolink&|}}</figure>+<figure "Lock Screen (Locker)">{{:apps:screensaver:screensaver-locker.png?610x635|}}</figure> 
 + 
 +----
  
 ==== Enable Lock Screen ==== ==== Enable Lock Screen ====
         * This is the master switch for the locker. This also integrates with Xfce4 [[:xfce:xfce4-power-manager:|Power Manager]], which can be launched using the button at the bottom of the tab.          * This is the master switch for the locker. This also integrates with Xfce4 [[:xfce:xfce4-power-manager:|Power Manager]], which can be launched using the button at the bottom of the tab. 
-        * Note that the locker will not actually run unless at least one activation listed below has been enabled. +        * Note that the locker will not automatically run unless at least one activation listed below has been enabled, although manual locking remains available.
 ==== Lock Screen with Screensaver ==== ==== Lock Screen with Screensaver ====
         * User has the option to decide how long the screensaver should run before the screen is locked.          * User has the option to decide how long the screensaver should run before the screen is locked. 
 ==== Lock Screen with System Sleep ==== ==== Lock Screen with System Sleep ====
         * Enable to allow Xfce4-screensaver to put the system to sleep (suspend).         * Enable to allow Xfce4-screensaver to put the system to sleep (suspend).
 +
 +----
 +
 ==== On Screen Keyboard ==== ==== On Screen Keyboard ====
-        * This is the first of two exceptions to locking the screen.+
         * Enabling this triggers an on-screen keyboard for login. The keyboard’s visibility before the screen was locked is remembered; a small toggle on the right end of the login screen can be used to restore visibility if required.         * Enabling this triggers an on-screen keyboard for login. The keyboard’s visibility before the screen was locked is remembered; a small toggle on the right end of the login screen can be used to restore visibility if required.
-        * The command to be entered may require a switch, for example: **onboard -e**+        * The command and any options to activate an installed on-screen keyboard may be entered in the command box. For example: **onboard -e** needs to be used to activate the onboard keyboard, if installed. 
 ==== Session Status Messages ==== ==== Session Status Messages ====
-        * The second exception when the screen is locked. 
         * When enabled, status messages will be shown despite the locked state.         * When enabled, status messages will be shown despite the locked state.
 +
 ==== Logout ==== ==== Logout ====
         * Enable to use Xfce4-screensaver to log out.         * Enable to use Xfce4-screensaver to log out.
         * Enter any required command, and use the counter below the slider to set the time interval before logout.         * Enter any required command, and use the counter below the slider to set the time interval before logout.
 +
 ==== User switching ==== ==== User switching ====
-        * Enable to allow Xfce4-screensaver to switch user+        * Enable to allow Xfce4-screensaver to switch user. 
 + 
 +[[|Back to Top]] 
 +---- 
 + 
 +===== Known Issues ===== 
 + 
 +Allow embedding a keyboard into the window, /embedded-keyboard-enabled, may be non-functional. Onboard crashes when embedded. 
 + 
 +---- 
 + 
 +===== Installation ===== 
 + 
 +See the file 'INSTALL' 
 + 
 +''./autogen.sh --prefix=/usr --sysconfdir=/etc'' 
 + 
 +You may need to set your PAM auth type if it is not correctly detected. 
 + 
 +''--with-pam-auth-type=<auth-type>   specify pam auth type (common or system)'' 
 + 
 +(For testing, we are using: 
 + ''./autogen.sh --disable-static --with-mit-ext --with-console-kit --enable-locking --enable-debug --sysconfdir=/etc'' 
 +) 
 + 
 +''make && sudo make install'' 
 + 
 + 
 +---- 
 + 
 +===== Latest Release ===== 
 +{{rss>https://archive.xfce.org/feeds/project/xfce4-screensaver 1 date description 2h}} 
 + 
 + 
 +  * **[[https://archive.xfce.org/src/apps/xfce4-screensaver/|Previous Releases]]** 
 + 
 +[[|Back to Top]] 
 +---- 
 +===== Source code repository ===== 
 +[[https://gitlab.xfce.org/apps/xfce4-screensaver]] 
 + 
 +---- 
 +===== Reporting Bugs ===== 
 +  * **[[:apps:xfce4-screensaver:bugs|Reporting Bugs]]** -- Open bug reports and how to report new bugs 
 + 
 +In the bug report please include information about your system, if possible: 
 + 
 + - What operating system and version 
 + - What version of xfce4-screensaver, i.e. the output of the ''xfce4-screensaver-command --version'' command 
 + 
 +If you want to debug your installation you may also be able to get meaningful debug output when starting xfce4-screensaver from the debug script: 
 +''./src/debug-screensaver.sh'' 
 + 
 +[[|Back To Top]] 
 +---- 
 +[[:apps:screensaver:start|Back to main Xfce documentation page]]