XScreenSaver(1) XScreenSaver(1) NNAAMMEE xscreensaver-demo - interactively control the background xscreensaver daemon SSYYNNOOPPSSIISS xxssccrreeeennssaavveerr--ddeemmoo [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-prefs] [-xrm _r_e_s_o_u_r_c_e_s] DDEESSCCRRIIPPTTIIOONN The _x_s_c_r_e_e_n_s_a_v_e_r_-_d_e_m_o program is a graphical front-end for setting the parameters used by the background xxssccrreeeenn-- ssaavveerr(1) daemon. It is essentially two things: a tool for editing the _~_/_._x_s_c_r_e_e_n_s_a_v_e_r file; and a tool for demoing the various graphics hacks that the _x_s_c_r_e_e_n_s_a_v_e_r daemon will launch. The main dialog box contains a scrolling list, a text field, and a number of buttons. Double-clicking on one of the programs in the list will run it. The screen will go black, and the program will run in full-screen mode, just as it would if the _x_s_c_r_e_e_n_- _s_a_v_e_r daemon had launched it. Clicking the mouse again will stop the demo and un-blank the screen, making the dialog box visible again. Single-clicking in the list will place the indicated pro- gram and its args in the text field to be edited. Edit the arguments and hit return to run the program with the parameters you have specified. This will also save your changes to your _~_/_._x_s_c_r_e_e_n_s_a_v_e_r file: so any changes you make in this way are persistent. If one of the lines in the scrolling list begins with the character "-", then that means that the program is dis- abled: _x_s_c_r_e_e_n_s_a_v_e_r will not select it to be run (though you can still try it out by clicking on it.) Rather than just deleting the programs you don't want to run, you might want to disable them in this way instead, so that you can more easily change your mind later. If the line begins with the name of a visual, followed by a colon, then that program will only be run on that kind of visual. For example, you can specify that a particular program should only be run if color is available, and another should only be run in monochrome. See the discus- sion of the _p_r_o_g_r_a_m_s parameter in the _C_o_n_f_i_g_u_r_a_t_i_o_n sec- tion of the xxssccrreeeennssaavveerr(1) manual. The buttons are: RRuunn NNeexxtt Clicking this button will run the next program in the list after the currently-selected one, and X Version 11 20-Jun-99 (3.15) 1 XScreenSaver(1) XScreenSaver(1) will wrap around to the top when it reaches the bottom. RRuunn PPrreevviioouuss Opposite of Run Next; at the top, it wraps around to the bottom. PPrreeffeerreenncceess This pops up a second dialog box, in which you have the option to interactively change most of the screensaver's operational parameters, such as its timeouts, and whether it should lock the screen. When you click OK, your chosen settings will take effect immediately, and will also be saved to the _~_/_._x_s_c_r_e_e_n_s_a_v_e_r file in your home directory, so that the settings will persist next time. QQuuiitt Exits the _x_s_c_r_e_e_n_s_a_v_e_r_-_d_e_m_o program. The back- ground _x_s_c_r_e_e_n_s_a_v_e_r daemon will continue running as before. The Preferences dialog box lets you change the following settings. (There are more settings available, but these are the most commonly used ones; see the manual for xxssccrreeeennssaavveerr(1) for other parameters that can be set by editing the _~_/_._x_s_c_r_e_e_n_s_a_v_e_r file, or the X resource database.) SSaavveerr TTiimmeeoouutt After the user has been idle this long, the _x_s_c_r_e_e_n_s_a_v_e_r daemon will blank the screen. CCyyccllee TTiimmeeoouutt After the screensaver has been running for this long, the currently running graphics demo will be killed, and a new one started. If this is 0, then the graphics demo will never be changed: only one demo will run until the screensaver is deactivated by user activity. VVeerrbboossee Whether to print lots of debugging information. IInnssttaallll CCoolloorrmmaapp Whether to install a private colormap while the screensaver is active, so that the graphics hacks can get as many colors as possible. (This only applies when the screen's default visual is being used, since non-default visuals get their own col- ormaps automatically.) This can also be overrid- den on a per-demo basis. X Version 11 20-Jun-99 (3.15) 2 XScreenSaver(1) XScreenSaver(1) FFaaddee CCoolloorrmmaapp If selected, then when the screensaver activates, the current contents of the screen will fade to black instead of simply winking out. This only works on displays with writable colormaps, that is, if the screen's default visual is a Pseudo- Color visual. A fade will also be done when switching graphics hacks (when the _C_y_c_l_e _T_i_m_e_o_u_t expires.) UUnnffaaddee CCoolloorrmmaapp The complement to _F_a_d_e _C_o_l_o_r_m_a_p: if selected, then when the screensaver deactivates, the original contents of the screen will fade in from black instead of appearing immediately. This only works on displays with writable colormaps, and when _F_a_d_e _C_o_l_o_r_m_a_p is also selected. FFaaddee DDuurraattiioonn When fading or unfading are selected, this con- trols how long the fade will take. FFaaddee TTiicckkss This controls how many times a second the colormap will be changed to effect a fade. Higher numbers yield smoother fades, but may make the fades take longer than the specified number of seconds, if your server isn't fast enough to keep up. RReeqquuiirree PPaasssswwoorrdd Whether the screen saver should lock the screen when it activates. LLoocckk TTiimmeeoouutt If _R_e_q_u_i_r_e _P_a_s_s_w_o_r_d is selected, this controls the length of the ``grace period'' between when the screensaver activates, and when the screen becomes locked. For example, if this is 0:05:00, and _S_a_v_e_r _T_i_m_e_o_u_t is 0:10:00, then after 10 minutes, the screen would blank. If there was user activ- ity at 12 minutes, no password would be required to un-blank the screen. But, if there was user activity at 15 minutes or later (that is, _L_o_c_k _T_i_m_e_o_u_t minutes after activation) then a password would be required. The default is 0, meaning that if locking is enabled, then a password will be required as soon as the screen blanks. PPaasssswwoorrdd TTiimmeeoouutt When the screensaver is prompting for a password, the prompt dialog box will stay on the screen for this long before giving up, and reverting to screen-saving mode. X Version 11 20-Jun-99 (3.15) 3 XScreenSaver(1) XScreenSaver(1) CCOOMMMMAANNDD--LLIINNEE OOPPTTIIOONNSS _x_s_c_r_e_e_n_s_a_v_e_r_-_d_e_m_o accepts the following command line options. --ddiissppllaayy _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n The X display to use. The _x_s_c_r_e_e_n_s_a_v_e_r_-_d_e_m_o pro- gram will open its window on that display, and also control the _x_s_c_r_e_e_n_s_a_v_e_r daemon that is man- aging that same display. --pprreeffss Start up in Preferences mode: this is just like launching the program with no arguments, and then pressing the _P_r_e_f_e_r_e_n_c_e_s button. It is important that the _x_s_c_r_e_e_n_s_a_v_e_r and _x_s_c_r_e_e_n_- _s_a_v_e_r_-_d_e_m_o processes be running on the same machine, or at least, on two machines that share a file system. When _x_s_c_r_e_e_n_s_a_v_e_r_-_d_e_m_o writes a new version of the _~_/_._x_s_c_r_e_e_n_- _s_a_v_e_r file, it's important that the _x_s_c_r_e_e_n_s_a_v_e_r see that same file. If the two processes are seeing different _~_/_._x_s_c_r_e_e_n_s_a_v_e_r files, things will malfunction. EENNVVIIRROONNMMEENNTT DDIISSPPLLAAYY to get the default host and display number. PPAATTHH to find the sub-programs to run. However, note that the sub-programs are actually launched by the _x_s_c_r_e_e_n_s_a_v_e_r daemon, not by _x_s_c_r_e_e_n_s_a_v_e_r_-_d_e_m_o itself. So, what matters is what $$PPAATTHH the _x_s_c_r_e_e_n_s_a_v_e_r program sees. HHOOMMEE for the directory in which to read and write the _._x_s_c_r_e_e_n_s_a_v_e_r file. XXEENNVVIIRROONNMMEENNTT to get the name of a resource file that overrides the global resources stored in the RESOURCE_MAN- AGER property. UUPPGGRRAADDEESS The latest version can always be found at http://www.jwz.org/xscreensaver/ SSEEEE AALLSSOO XX(1), xxssccrreeeennssaavveerr(1), xxssccrreeeennssaavveerr--ccoommmmaanndd(1) CCOOPPYYRRIIGGHHTT Copyright (C) 1992, 1993, 1997, 1998, 1999 by Jamie Zawin- ski. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in sup- porting documentation. No representations are made about X Version 11 20-Jun-99 (3.15) 4 XScreenSaver(1) XScreenSaver(1) the suitability of this software for any purpose. It is provided "as is" without express or implied warranty. AAUUTTHHOORR Jamie Zawinski , 13-aug-92. Please let me know if you find any bugs or make any improvements. X Version 11 20-Jun-99 (3.15) 5