.Dd April 10, 2025
.Dt screensaver 1
.Os
.Sh NAME
.Nm screensaver
.Nd Tool to display screensaver plugins fullscreen
.Sh SYNOPSIS
.Nm
.Fl h | \-version | l
.Nm
.Op Fl r
.Op Fl w
.Op Ar
.Sh DESCRIPTION
The
.Nm
tool displays a graphic animation, either fullscreen on the primary screen (the
default), or in a window, when the
.Fl w
flag is given.
When no argument is supplied,
.Nm
will display a default module.
Otherwise, it will load and use the specified module.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl h, \-help
Print help text and exit.
.It Fl l, \-list
List all available modules, with their current version numbers.
.It Fl r, \-random
Choose a module randomly, and use that.
.It Fl w, \-window
Show the animation in a resizable window, so you can drag it to another screen,
for example.
.It Fl \-version
Print version info and exit.
.El
.\" .Sh ENVIRONMENT
.\" For sections 1, 6, 7, and 8 only.
.Sh FILES
.Bl -tag -width Ds
.It Pa /usr/local/share/screensaver/plugins
This directory is where the screensaver modules are installed,
along with their JSON configuration files, if any.
The first part of this path,
.Pa /usr/local ,
could be another prefix, depending on the prefix used when the screensaver and
its modules were installed.
.El
.Sh EXIT STATUS
.Nm
exits 0 on success, and 1 if an error occurs.
.\" .Sh EXAMPLES
.\" .Sh DIAGNOSTICS
.\" For sections 1, 4, 6, 7, 8, and 9 printf/stderr messages only.
.\" .Sh SEE ALSO
.\" .Xr foobar 1
.\" .Sh STANDARDS
.\" .Sh HISTORY
.Sh AUTHORS
.An Bob Polis
.\" .Sh CAVEATS
.\" .Sh BUGS
.\" .Sh SECURITY CONSIDERATIONS
.\" Not used in OpenBSD.