README

XPlanet Scripts v1.0
written by Patrick Jennings
https://github.com/patrickjennings/XPlanet-Scripts

--------------------------------------------------------------------------------
About the script

I wrote the following script in order to easily setup a nice looking xplanet
background image on to a Linux desktop.

The script were written specifically for the GNU/Linux platform but should work
for all Unix compliant systems with access to Bash shell, cURL, and coreutils.
The xplanet package is required to be installed.

--------------------------------------------------------------------------------
Installation

1. Install the script and images:
	$ ./install.sh

This creates the directory structure in ~/.xplanet by default.

--------------------------------------------------------------------------------
Usage

$ .~/xplanet.sh

--------------------------------------------------------------------------------
Changing DE Wallpaper

1a. Gnome 2 - gconftool-2

Uncomment the following line at the end of xplanet.sh:

gconftool-2 -t str -s /desktop/gnome/background/picture_filename "$OUTPUTFILE"


1b. KDE 4 - Scripted Image Wallpaper plugin

Uncomment the echo "$OUTPUTFILE" line at the end of xplanet.sh.
Use ~/.xplanet/xplanet.sh for the script path.

http://kde-look.org/content/show.php/Scripted+Image+Wallpaper+Plugin?content=115147


1c. KDE 5 - Slideshow wallpaper

There is currently no interface for changing the plasma wallpaper. The only
solution is to use a slideshow wallpaper and set a cron job to execute the
xplanet script. Hopefully this will change.

--------------------------------------------------------------------------------
Uninstallation

1. Delete directory structure:
	$ rm -r ~/.xplanet

--------------------------------------------------------------------------------
Options

All configuration files will be in the users home directory:
~/.xplanet

xplanet.sh:
	Options for editing the resulting xplanet image (latitude, longitude,
	geometry, output file, etc) are located in this script.

--------------------------------------------------------------------------------
Resources

NASA's Visible Earth:
	<http://visibleearth.nasa.gov/view_set.php?categoryId=2363&p=1>

XPlanet:
	<http://xplanet.sourceforge.net/>