HELLCAT's Wallpaper-Changer
==============================
(if you find spelling mistakes or other typos in here, bare with me, this was written at 5am in the morning, with NO coffee....)

This tiny, little something was inspired by a thread at the QJ forums, where someone asked for such a thing, but noone could find one :-D
So I though "Hey, can't hurt to just make a quick one" :-)

And so, here we are:

The name's the deal: This small CFW plugin changes your XMB background, a.k.a. "paper of the wall", or in short "wallpaper".
That's it. Not more, not less.

However, you have a few options:

- Two "modes": "Everytime" and "Once per day" (see below)
- Predefined images for any specific date

IMPORTANT:
Only (!) put 480x272 .BMP files into the wallpaper folders!
Using differently sized ones or even other file formats (like .JPG, .GIF, .PNG or the such) will cause weird'n'strange side effects. (all will be fine once a 480x272 .BMP is used again, or the wallpaper is disabled completely)
Don't do that.

N00b-Note:
You must have set "Use Wallpaper" to "ON" or "YES", or whatever the phrase is, in the Theme-Settings of your PSP for the papers to show up! ;-)


Installation
===============

Copy wpchanger.prx into /seplugins on your memstick (create the folder, if it doesn't exist).
Open (or create) vsh.txt and add this line:
ms0:/seplugins/wpchanger.prx

Done, base installation is finished. Didn't hurt, eh? ;-)


Usage
========

This wallpaper changer fetches the images to use from the folder /PICTURE/WALLPAPER on your memstick.
From all images you put in there, this wallpaper changer will pick one randomly and set it as the next wallpaper for the XMB.

Date-Based wallpapers
------------------------
Like stated, you can set a predefined image for any given date.
The special (fixed) wallpaper for a specific day are fetched from /PICTURE/DATEPAPER
The names of the images in there follow a very simply rule: mm-dd.bmp with "mm" beeing the month (two digits, WITH leading zeros!) and "dd" is the day of the month (again, with leading zeros).
So, if you want to make a special wallpaper for January 12th, you'd name the file 01-12.bmp and put it into /PICTURE/DATEPAPER so the complete path would be
/PICTURE/DATEPAPER/01-12.bmp

As another example, for March, 33rd ;-) it'd be:
/PICTURE/DATEPAPER/03-33.bmp

If a special (fixed) wallpaper is defined this way for the current day, only this wallpaper will be set instead of a random one from the .../WALLPAPER directory.
SO you will see the special wallpaper all day long (unless you delete it from .../DATEPAPER, which will result in a random wallpaper again).

Obviously, you can mix both kinds of wallpapers.
Usually having random ones and for special days (birthday, aniversary, reminder, whatever....) you can set a predefined and fixed one.

Modes ("Evertime" and "Once per day")
----------------------------------------
By default a new wallpaper is set on EVERY XMB startup. That also counts in leaving a game or homebrew!
If you only want to have your wallpaper changed once a day, you can "tell" the plugin to do so:
When turning on your PSP, hold the /\ (Triangle) button pressed until the XMB shows up.
This will switch the wallpaper changer into "Once per day" mode and the wallpaper will only be changed on the first startup of a day.

If you feel more randomish again, holdin O (Circle) while turning on the PSP switched back to "Everytime" mode.


To look out for
==================

There's a few things I'd to point out, to prevent confusion:

*
To avoid collisions or interference with the XMBs startup, the wallpaper changer waits a few seconds before actually applying a new wallpaper.
So, if you're one of the real quick ones and launch a game/homebrew within the first 10 seconds after the XMB showed up, you'll get not change since you already killed it before it could do it's job ;-)

*
Since the new wallpaper is set AFTER the XMB has already started up, it only takes affect after the next restart of the XMB by either powercycling the PSP or leaving a game/homebrew.
This is why you might not yet see the correct predefined image on a days first startup, or one more change after switching to "Once per day" mode.
After the next restart all will be fine again ;-)



Well, this is pretty much it.

Have fun! :-)
