Quick start

Quick start

• The folder in the archive must be placed somewhere you have write permissions.
• The rendered wallpapers will be generated within the _output subfolder.
• The script must have write access to a temporary folder (defaults to /tmp ) but you can change that
• You can start the script with:

$ bash /path/to/the/script/folder/planet_slideshow.sh -h

to get the instructions and most common usage patterns.
NOTE! it is best to start it with bash, not by making it executable and starting it with ./planet_slideshow.sh

• For the things to work you have to have: ImageMagick and XPlanet.

The following programs must be present in your path:
- "nice" : used to perform all the computations of the script with lower CPU priority
- "xplanet" : it will render 3D Earth, Moon. You do not need any image maps, the script uses its own.
- "convert": part of the ImageMagick, performs layering, composition, etc. of all involved images
- "pom" : optional, to compute the current phase of the moon. It is usually found in "BSD classic text games" packages.

• Options can be given as command line or directly change the values of variables defined in the first section of the script.