The FreeBSD Diary

Xplanet is program which displays a picture of the Earth. It was inspired by Xearth. Xplanet can draw all the major planets and most satellites. I use it to provide the background image on my machines which run X. You can also download satellite images of cloud cover so your background reflect reality. I also display the daylight/darkness shadow. It makes for a very interesting and dynamic background. Have a look at their gallery of images. Very nice eye candy!

The image below is is an example of what I have on my laptop. If you click on it, you'll see the full 1024x768 image. Also present, but from a different time of day, is what the screen shot looks like without clouds.

I am assuming you already have X up and runnning. I am also using KDE in this example. I'm sure the instructions for other window managers will be simliar.

It's been just over 5 days since the Sunday BSDCan breakfast. I spent Monday doing nothing much. Tuesday involved a few emails. Wednesday I did a lot of changes to the BSDCan website to get a /2004/ archive going. That should be ready soon. This morning (Thursday) I updated the ad serving software. In the process, I found this half-completed article and thought I should update and commit it before it got lost. It's also a nice break from the accounting and receipt wrap-up of BSDCan.

Use the ports, of course.

cd /usr/ports/astro/xplanets
make install

Here is how I configured Xplanet on my IBM ThinkPad T22 running FreeBSD 5.2.1:

1. Start KDE (I'm running KDE 3.2.2).
2. Right click on the background.
3. Select Configure Desktop.
4. Click on Background in the left hand panel.
5. In the Background group box, I have No picture selected.
6. Click on Advanced Options.
7. I have Use the following program for drawing the background checked.
8. Select XPlanet in the list (I also have kdeworld and kwebdesktop listed).
9. Click on Modify.
10. My Command entry is:

    xplanet --num_times 1 --geometry %xx%y --output %f.jpg --projection \
    merc --latitude -5 && mv %f.jpg %f
    

    You'll probably want to combine those two lines into one.

11. My Preview cmd entry is:

    xplanet --num_times 1 --geometry %xx%y --output %f.jpg --projection \
    merc --latitude -5 && mv %f.jpg %f
    

    Again, you'll probably want to combine those two lines into one.

12. I have my Refresh time set to 5 minutes.

With that, you should have an Xplanet background.

You don't have clouds yet. The Xplanet Maps & Scripts pages shows you how to do this. There are two parts:

1. obtain a cloud map
2. tell Xplanet to use it

Cloud images are updated every three hours. There is no sense in getting the maps any more often than that. Please do not abuse this service. Do not run your cronjob any more often than that. Many cloud map servers have been shut down because of people fetching more often than necessary.

Get the map

Note: I had to install www/p5-ParallelUA to get the script to run.

Tell Xplanet about the map

Xplanet has a rather extensive man page. It also has configuration files at /usr/X11R6/share/xplanet/config. The file I changed is /usr/X11R6/share/xplanet/config/default and I added this entry:

cloud_map=/home/dan/clouds_2048.jpg

The file referenced by the cloud_map entry is also specified within the script I referred to above.

In later versions of xplanet, that entry should be placed within the Earth section, as shown below:

[earth]
"Earth"
color={28, 82, 110}

cloud_map=/home/dan/clouds/clouds_2048.jpg

The settings not related to cloud_map are the values I found in the file:

I created a shell script to invoke the above mentioned perl script. This shell script ensure that we always have a valid cloud map.

#!/bin/sh
cd ~/clouds
perl ~/clouds/download_clouds.pl
if [ -s clouds.jpg ]
then
	RESULT=`file clouds.jpg | grep -c "JPEG image data"`
	if [ $RESULT -eq 1 ]
	then
		mv clouds.jpg clouds_2048.jpg
	else
		rm clouds.jpg
	fi
else
	rm clouds.jpg
fi

It invokes the perl script, then makes sure that the resulting file is non-zero in size. The script then verifies that the file is a JPEG image, as opposed to an HTML file as might be returned in a 404 error. If all is OK, it moves the fetched over over the stored file and finishes.

The cronjob I use to invoke the shell script is:

15  */3   *   *   *   dan       /home/dan/bin/clouds.sh

This will run at 15 past the hour, every three hours.

Once it has run sucessfully, you can get rid of the output that is mailed to you by adding the following to the end of the line:

2>&1; > /dev/null

That should be everything you need to have a much more interesting background. Enjoy.