68 lines
1.6 KiB
Groff
68 lines
1.6 KiB
Groff
.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.
|