A quick description of the content of this repo.

FILES:

APOD.pm:
	A Perl module for accessing the Astronomy Picture Of the Day as
	well as its description.

apod_get:
	A Perl script which saves the image and description file either of
	todays APOD, or the APOD specified by an optional URL argument. 
	It also has an archiving mode, which creates a 'latest/'-subdirectory
       	in the download path which contains symlinks to the downloaded files.

apod_getrss:
	A Perl script which saves the image and description files for each APOD
	provided by NASAs APOD RSS feed into the current directory.

apod_setbg:
	A bash script which generates a resized (to your desktop or a custom 
	size, by using linnea_annotate) and optionally annotated image which it 
	then sets as the desktop background.

apod_archive_setbg:
	Runs apod_get --archive and apod_setbg. It takes an APOD URL as an 
	optinal argument and passes it on to apod_get. 
	I run this from my local crontab ('crontab -e').

linnea_annotate:
	A text annotator written in Perl; it produces a scaled and annotated 
	copy of a supplied image. Although this turned out as a part of the 
	APOD code, it's now a generally useful standalone program for creating
	captioned images.

font/:
	A free truetype font which is used by default for the annotator.

NOTES:

linnea_annotate (used by apod_setbg) can't automatically determine the desktop
size (the '--desktop-size' option) if it's run from an other user since it needs
all your environment variables and such to do it. Use the '-s'-option for 
apod_setbg to set the desktop dimension manually.

You can modify how the background is to be set by setting the APOD_BG_SET
environment variable. For example:
    $ export APOD_BG_SET="hsetroot --center"
apod_setbg will try a few alternatives if it isn't set.