RotateWallpaper

By Mitch Stuart
Copyright © 2005 FullSpan Software - Usage subject to license
Software Version: 1.0 - Document Version: $Revision: 1.3 $, $Date: 2005/09/22 18:27:28 $

About RotateWallpaper

RotateWallpaper scans a directory of image files, and replaces the Windows desktop wallpaper with one of those images. It can select the new image at random, or by cycling through each image in alphabetical order.

Getting RotateWallpaper

Download a package including binary executable files, source code, and documentation: [RotateWallpaper.zip]
View the C# source code

Installing RotateWallpaper

Prerequisite: .NET Framework
RotateWallpaper requires the Microsoft .NET Framework. RotateWallpaper was written and tested with .NET Framework version 2.0.50215. If the .NET Framework is not already installed on your computer, you will need to install it.

To install RotateWallpaper, extract the .zip distribution file into a temporary directory. Copy the contents of RotateWallpaper\bin\Release to a directory of your choice (for example, C:\Program Files\FullSpan\RotateWallpaper). We will call this directory INSTALL_DIR.

Running RotateWallpaper

Image Directory
To run RotateWallpaper, you will need a directory in which you store your wallpaper images. These are files of type .jpg, .gif, or .bmp. A small set of sample image is provided in the .zip file in RotateWallpaper\SampleImages. You can either use this directory or create your own. We will call this directory IMAGES_DIR.

RotateWallpaper is a command-line program. Open a Command Prompt window ("DOS box"). You can run the program in two modes:

To have RotateWallpaper randomly select an image file from the images directory:
```
  INSTALL_DIR\RotateWallpaper Random IMAGES_DIR
```
To have RotateWallpaper select the next image in alphabetical order from the images directory:
```
  INSTALL_DIR\RotateWallpaper Cycle IMAGES_DIR
```
In Cycle mode, the first time you run RotateWallpaper it will select the first image (in alphabetical order) in the images directory. Then each time you run it, it will select the next image. When it reaches the last image in the directory, it will cycle back to the first image.

Scheduled Task
The typical way to use RotateWallpaper is to set it up as a Scheduled Task, so that your wallpaper is automatically rotated once a day (or however often you want).

License and External Libraries

RotateWallpaper is released under the FullSpan license.

In addition, RotateWallpaper uses the following external libraries, which are used and distributed under license from their copyright holders:

Component Description License

Apache log4net "log4net is a tool to help the programmer output log statements to a variety of output targets. log4net is a port of the excellent log4j framework to the .NET runtime." This product includes software developed by The Apache Software Foundation.

log4net-LICENSE.txt