1 /* xscreensaver-command, Copyright (c) 1991-2004 Jamie Zawinski <jwz@jwz.org>
3 * Permission to use, copy, modify, distribute, and sell this software and its
4 * documentation for any purpose is hereby granted without fee, provided that
5 * the above copyright notice appear in all copies and that both that
6 * copyright notice and this permission notice appear in supporting
7 * documentation. No representations are made about the suitability of this
8 * software for any purpose. It is provided "as is" without express or
20 #include <sys/types.h>
26 #include <X11/Xproto.h> /* for CARD32 */
28 #include <X11/Xatom.h>
29 #include <X11/Xutil.h> /* for XGetClassHint() */
32 #include <X11/Intrinsic.h> /* only needed to get through xscreensaver.h */
38 ERROR! you must not include vroot.h in this file
44 Atom XA_SCREENSAVER, XA_SCREENSAVER_VERSION, XA_SCREENSAVER_RESPONSE;
45 Atom XA_SCREENSAVER_ID, XA_SCREENSAVER_STATUS, XA_SELECT, XA_DEMO, XA_EXIT;
46 Atom XA_BLANK, XA_LOCK;
47 static Atom XA_ACTIVATE, XA_DEACTIVATE, XA_CYCLE, XA_NEXT, XA_PREV;
48 static Atom XA_RESTART, XA_PREFS, XA_THROTTLE, XA_UNTHROTTLE;
50 static char *screensaver_version;
52 __extension__ /* don't warn about "string length is greater than the
53 length ISO C89 compilers are required to support" in the
56 static char *usage = "\n\
57 usage: %s -<option>\n\
59 This program provides external control of a running xscreensaver process.\n\
60 Version %s, copyright (c) 1991-2003 Jamie Zawinski <jwz@jwz.org>.\n\
62 The xscreensaver program is a daemon that runs in the background.\n\
63 You control a running xscreensaver process by sending it messages\n\
64 with this program, xscreensaver-command. See the man pages for\n\
65 details. These are the arguments understood by xscreensaver-command:\n\
67 -demo Ask the xscreensaver process to enter interactive demo mode.\n\
69 -prefs Ask the xscreensaver process to bring up the preferences\n\
72 -activate Turn on the screensaver (blank the screen), as if the user\n\
73 had been idle for long enough.\n\
75 -deactivate Turns off the screensaver (un-blank the screen), as if user\n\
76 activity had been detected.\n\
78 -cycle If the screensaver is active (the screen is blanked), then\n\
79 stop the current graphics demo and run a new one (chosen\n\
82 -next Like either -activate or -cycle, depending on which is more\n\
83 appropriate, except that the graphics hack that will be run\n\
84 is the next one in the list, instead of a randomly-chosen\n\
85 one. In other words, repeatedly executing -next will cause\n\
86 the xscreensaver process to invoke each graphics demo\n\
87 sequentially. (Though using the -demo option is probably\n\
88 an easier way to accomplish that.)\n\
90 -prev Like -next, but goes in the other direction.\n\
92 -select <N> Like -activate, but runs the Nth element in the list of\n\
93 hacks. By knowing what is in the `programs' list, and in\n\
94 what order, you can use this to activate the screensaver\n\
95 with a particular graphics demo. (The first element in the\n\
96 list is numbered 1, not 0.)\n\
98 -exit Causes the xscreensaver process to exit gracefully. This is\n\
99 roughly the same as killing the process with `kill', but it\n\
100 is easier, since you don't need to first figure out the pid.\n\
101 (Note that one must *never* kill xscreensaver with -9!)\n\
103 -restart Causes the screensaver process to exit and then restart with\n\
104 the same command line arguments as last time. Do this after\n\
105 you've changed your X resource settings, to cause\n\
106 xscreensaver to notice the changes.\n\
108 -lock Tells the running xscreensaver process to lock the screen\n\
109 immediately. This is like -activate, but forces locking as\n\
110 well, even if locking is not the default. If the saver is\n\
111 already active, this causes it to be locked as well.\n\
113 -version Prints the version of xscreensaver that is currently running\n\
114 on the display -- that is, the actual version number of the\n\
115 running xscreensaver background process, rather than the\n\
116 version number of xscreensaver-command.\n\
118 -time Prints the time at which the screensaver last activated or\n\
119 deactivated (roughly, how long the user has been idle or\n\
120 non-idle -- but not quite, since it only tells you when the\n\
121 screen became blanked or un-blanked.)\n\
123 -watch Prints a line each time the screensaver changes state: when\n\
124 the screen blanks, locks, unblanks, or when the running hack\n\
125 is changed. This option never returns; it is intended for\n\
126 by shell scripts that want to react to the screensaver in\n\
129 See the man page for more details.\n\
130 For updates, check http://www.jwz.org/xscreensaver/\n\
133 /* Note: The "-throttle" command is deprecated -- it predates the XDPMS
134 extension. Instead of using -throttle, users should instead just
135 power off the monitor (e.g., "xset dpms force off".) In a few
136 minutes, the xscreensaver daemon will notice that the monitor is
137 off, and cease running hacks.
140 #define USAGE() do { \
141 fprintf (stderr, usage, progname, screensaver_version); exit (1); \
144 static int watch (Display *);
147 main (int argc, char **argv)
155 Atom XA_WATCH = 0; /* kludge: not really an atom */
158 s = strrchr (progname, '/');
159 if (s) progname = s+1;
161 screensaver_version = (char *) malloc (5);
162 memcpy (screensaver_version, screensaver_id + 17, 4);
163 screensaver_version [4] = 0;
165 for (i = 1; i < argc; i++)
167 const char *s = argv [i];
169 if (s[0] == '-' && s[1] == '-') s++;
172 if (!strncmp (s, "-display", L)) dpyname = argv [++i];
173 else if (cmd) USAGE();
174 else if (!strncmp (s, "-activate", L)) cmd = &XA_ACTIVATE;
175 else if (!strncmp (s, "-deactivate", L)) cmd = &XA_DEACTIVATE;
176 else if (!strncmp (s, "-cycle", L)) cmd = &XA_CYCLE;
177 else if (!strncmp (s, "-next", L)) cmd = &XA_NEXT;
178 else if (!strncmp (s, "-prev", L)) cmd = &XA_PREV;
179 else if (!strncmp (s, "-select", L)) cmd = &XA_SELECT;
180 else if (!strncmp (s, "-exit", L)) cmd = &XA_EXIT;
181 else if (!strncmp (s, "-restart", L)) cmd = &XA_RESTART;
182 else if (!strncmp (s, "-demo", L)) cmd = &XA_DEMO;
183 else if (!strncmp (s, "-preferences",L)) cmd = &XA_PREFS;
184 else if (!strncmp (s, "-prefs",L)) cmd = &XA_PREFS;
185 else if (!strncmp (s, "-lock", L)) cmd = &XA_LOCK;
186 else if (!strncmp (s, "-throttle", L)) cmd = &XA_THROTTLE;
187 else if (!strncmp (s, "-unthrottle", L)) cmd = &XA_UNTHROTTLE;
188 else if (!strncmp (s, "-version", L)) cmd = &XA_SCREENSAVER_VERSION;
189 else if (!strncmp (s, "-time", L)) cmd = &XA_SCREENSAVER_STATUS;
190 else if (!strncmp (s, "-watch", L)) cmd = &XA_WATCH;
193 if (cmd == &XA_SELECT || cmd == &XA_DEMO)
197 if (i+1 < argc && (1 == sscanf(argv[i+1], " %ld %c", &a, &c)))
209 /* no command may have a negative argument. */
213 /* SELECT must have a non-zero argument. */
214 if (cmd == &XA_SELECT)
219 /* no command other than SELECT and DEMO may have a non-zero argument. */
220 if (cmd != &XA_DEMO && cmd != &XA_SELECT)
226 /* For backward compatibility: -demo with no arguments used to send a
227 "DEMO 0" ClientMessage to the xscreensaver process, which brought up
228 the built-in demo mode dialog. Now that the demo mode dialog is no
229 longer built in, we bring it up by just running the "xscreensaver-demo"
232 Note that "-DEMO <n>" still sends a ClientMessage.
234 if (cmd == &XA_PREFS ||
235 (cmd == &XA_DEMO && arg == 0))
238 char *new_argv[] = { "xscreensaver-demo", 0, 0, 0, 0, 0 };
243 new_argv[ac++] = "-display";
244 new_argv[ac++] = dpyname;
247 if (cmd == &XA_PREFS)
248 new_argv[ac++] = "-prefs";
252 execvp (new_argv[0], new_argv); /* shouldn't return */
254 sprintf (buf, "%s: could not exec %s", progname, new_argv[0]);
263 if (!dpyname) dpyname = (char *) getenv ("DISPLAY");
269 "%s: warning: $DISPLAY is not set: defaulting to \"%s\".\n",
273 dpy = XOpenDisplay (dpyname);
276 fprintf (stderr, "%s: can't open display %s\n", progname,
277 (dpyname ? dpyname : "(null)"));
281 XA_VROOT = XInternAtom (dpy, "__SWM_VROOT", False);
282 XA_SCREENSAVER = XInternAtom (dpy, "SCREENSAVER", False);
283 XA_SCREENSAVER_ID = XInternAtom (dpy, "_SCREENSAVER_ID", False);
284 XA_SCREENSAVER_VERSION = XInternAtom (dpy, "_SCREENSAVER_VERSION",False);
285 XA_SCREENSAVER_STATUS = XInternAtom (dpy, "_SCREENSAVER_STATUS", False);
286 XA_SCREENSAVER_RESPONSE = XInternAtom (dpy, "_SCREENSAVER_RESPONSE", False);
287 XA_ACTIVATE = XInternAtom (dpy, "ACTIVATE", False);
288 XA_DEACTIVATE = XInternAtom (dpy, "DEACTIVATE", False);
289 XA_RESTART = XInternAtom (dpy, "RESTART", False);
290 XA_CYCLE = XInternAtom (dpy, "CYCLE", False);
291 XA_NEXT = XInternAtom (dpy, "NEXT", False);
292 XA_PREV = XInternAtom (dpy, "PREV", False);
293 XA_SELECT = XInternAtom (dpy, "SELECT", False);
294 XA_EXIT = XInternAtom (dpy, "EXIT", False);
295 XA_DEMO = XInternAtom (dpy, "DEMO", False);
296 XA_PREFS = XInternAtom (dpy, "PREFS", False);
297 XA_LOCK = XInternAtom (dpy, "LOCK", False);
298 XA_BLANK = XInternAtom (dpy, "BLANK", False);
299 XA_THROTTLE = XInternAtom (dpy, "THROTTLE", False);
300 XA_UNTHROTTLE = XInternAtom (dpy, "UNTHROTTLE", False);
304 if (cmd == &XA_WATCH)
310 if (*cmd == XA_ACTIVATE || *cmd == XA_LOCK ||
311 *cmd == XA_NEXT || *cmd == XA_PREV || *cmd == XA_SELECT)
312 /* People never guess that KeyRelease deactivates the screen saver too,
313 so if we're issuing an activation command, wait a second. */
316 i = xscreensaver_command (dpy, *cmd, arg, True, NULL);
326 Window window = RootWindow (dpy, 0);
327 XWindowAttributes xgwa;
332 XGetWindowAttributes (dpy, window, &xgwa);
333 XSelectInput (dpy, window, xgwa.your_event_mask | PropertyChangeMask);
337 XNextEvent (dpy, &event);
338 if (event.xany.type == PropertyNotify &&
339 event.xproperty.state == PropertyNewValue &&
340 event.xproperty.atom == XA_SCREENSAVER_STATUS)
344 unsigned long nitems, bytesafter;
345 unsigned char *dataP = 0;
347 if (XGetWindowProperty (dpy,
348 RootWindow (dpy, 0), /* always screen #0 */
349 XA_SCREENSAVER_STATUS,
350 0, 999, False, XA_INTEGER,
351 &type, &format, &nitems, &bytesafter,
359 Bool changed = False;
360 Bool running = False;
361 CARD32 *data = (CARD32 *) dataP;
363 if (type != XA_INTEGER || nitems < 3)
366 if (last) XFree (last);
367 if (data) XFree (data);
368 fprintf (stderr, "%s: bad status format on root window.\n",
373 tt = (time_t) data[1];
374 if (tt <= (time_t) 666000000L) /* early 1991 */
378 if (s[strlen(s)-1] == '\n')
381 if (!last || data[0] != last[0])
384 if (data[0] == XA_BLANK)
385 printf ("BLANK %s\n", s);
386 else if (data[0] == XA_LOCK)
387 printf ("LOCK %s\n", s);
388 else if (data[0] == 0)
389 printf ("UNBLANK %s\n", s);
399 for (i = 2; i < nitems; i++)
401 if (data[i] != last[i])
408 if (running && changed)
411 fprintf (stdout, "RUN");
412 for (i = 2; i < nitems; i++)
413 fprintf (stdout, " %d", (int) data[i]);
414 fprintf (stdout, "\n");
419 if (last) XFree (last);
424 if (last) XFree (last);
425 if (dataP) XFree (dataP);
426 fprintf (stderr, "%s: no saver status on root window.\n",