Your company here — click to reach over 10,000 unique daily visitors

glslideshow - Man Page

slideshow of images using smooth zooming and fades


glslideshow [--display host:display.screen] [--visual visual] [--window] [--root] [--window-id number] [--duration seconds] [--zoom percent] [--pan seconds] [--fade seconds] [--titles] [--letterbox | --clip] [--delay usecs] [--fps] [--debug] [--wireframe] [--cutoff int]


Loads a random sequence of images and smoothly scans and zooms around in each, fading from pan to pan.  

This program requires a good video card capable of supporting large textures.

To specify the directory that images are loaded from, run xscreensaver-settings(1) and click on the "Advanced" tab.


--visual visual

Specify which visual to use.  Legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual.


Draw on a newly-created window.  This is the default.


Draw on the root window.

--window-id number

Draw on the specified window.

--duration seconds

How long each image will be displayed before loading a new one. Default 30 seconds.

--pan seconds

How long each pan-and-zoom should last.  Default 6 seconds.

With the default settings of --pan 6 --duration 30, each image will be displayed five times (30/6), and then a new image will be loaded. If you want a new image to be loaded at each fade, then set --pan and --duration to the same value.

--fade seconds

How long each cross-fade between images should last.  Default 2 seconds. If set to 0, then no cross-fading will be done (all transitions will be jump-cuts.)

Note that fades are included in the pan time, so --fade cannot be larger than --pan.

--zoom number

Amount to zoom and pan as a percentage. Default: 75, meaning that 75% or more of each image will always be visible.  If set to 100%, then the images will always fill the screen, and no panning or  zooming will occur.  (Images will still smoothly fade from one to another if --fade is non-zero.)


Whether to print the file name of the current image in the upper left corner.


In "letterbox" mode, when an image is not the same aspect ratio as the screen, black bars will appear at the top/bottom or left/right so that the whole image can be displayed.  This is the default.


In "clip" mode, when an image is not the same aspect ratio as the screen, we will zoom in further until the image takes up the whole screen. This is the opposite of --letterbox.

--delay number

Per-frame delay, in microseconds.  Default: 20000 (0.02 seconds.).


Display the current frame rate, CPU load, and polygon count.

--cutoff number

If the frame rate we are achieving is lower than this, then panning, fading, and zooming will be disabled.  Default 5 FPS.

The idea here is that if your machine can't maintain a decent frame rate, then it must not have fast 3D hardware, so we might as well behave in a simpler manner.  Set this to 0 to disable this check.


Prints debugging info to stderr.


Another debug mode.



to get the default host and display number.


to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.


The window ID to use with --root.

See Also

X(1), xscreensaver-settings(1), xscreensaver-getimage(6x), xscreensaver(1), carousel(6x) photopile(6x)


Jamie Zawinski and Mike Oliphant.


6.09-1.fc41 (11-Jun-2024) X Version 11 XScreenSaver manual