HELLCAT's Wallpaper Changer PSP

HELLCAT's Wallpaper Changer
General
Author	Hellcat
Type	Plugins
Version	1.20
License	GPL-3.0
Last Updated	2008/03/15
Links
1.20 - Old Versions
Website
Source

This PSP CFW plugin changes your XMB background.

It comes with two PC based (Windows) tools for converting images into fitting wallpaper .BMPs or proper 01-12.bmp replacements.

Features

• Two modes of operation: "Everytime" and "Once per day".
• You can set special, predefined images for a specific date.
• Change the XMB background behind the waves (a.k.a. 01-12.bmp) - without writing to flash.
• Randomizing/Changing of PTF themes.
• Randomizing/Changing of gameboot.
• Randomizing/Changing of XMB waves.
• Randomizing/Changing of XMB font.

Installation

Copy wpchanger.prx into ms0:/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

Now go into Recovery Menu and enable the plugin.

An even more strict exception are the "wavepapers" (see bellow), those sizes are quite smaller!

User guide

Wallpapers

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.

Notes:

• 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)
• You must have set "Use Wallpaper" to "ON" or "YES" in the Theme-Settings of your PSP for the papers to show up.

Wallpapers behind the XMB waves

The wallpaper changer can also change/randomize the background behind the waves in the XMB, so you keep the waves showing on top. The nice thing: It does it without touching the flash0:.

The wallpapers for the background behind the waves got into the following folder on your memstick: /PICTURE/WAVEPAPER/.

They usually have a resolution of 60x34 - usual restrictions for 01-12.bmp (a.k.a. background behind waves) replacement still apply (filesizes and such).

Notes:

• If you only get a white background, you don't have a proper multi-image 01-12.bmp (Fat and Slim) or 13-27.bmp (the Slims new additional colors) replacement.
• There are two things you can do about this:
  • Select the very first of the Slims additional colors (that pinky one) or the silver/grey color for January (works on Fat+Slim).
  • Try using the PC tool "Wavepaper Stitcher" to generate 01-12.bmp (or 13-27.bmp) replacement multi-image .BMP.

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, anniversary, reminder, whatever....) you can set a predefined and fixed one.

"Everytime" and "Once per day" modes

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, holding Circle while turning on the PSP switches back to "Everytime" mode.

PTF theme randomizing

If you use PTF themes, you know that the PSP uses the folder /PSP/THEME for it, if you choose to change the theme the PSP it gives you the PTFs in there to choose from.

The Wallpaper-Changer also just uses this folder. If it exists, and has .PTFs in it, it grab one randomly and sets it as current theme. Short and simple.

You can disable the changing/randomizing of .PTF themes, for the case you have some of them stored on your memstick but just don't want your current theme changed by the Wallpaper-Changer.

To do so, hold Square while booting the PSP until the XMB shows up - this will disable the changing/randomizing of .PTF themes. To turn it back on, hold Square again during boot and it'll toggle back to changing the themes.

Gameboot randomizing

Put your collection of gameboots in /PSP/GAMEBOOT/ on your memstick and a random one of them will be played when you launch a game/app.

Custom XMB wave randomizing

Same as gameboot, just place your system_plugin_bg.rco replacements in /PSP/WAVE/ on your memstick.

Note: A custom XMB wave may/will cause the gameboot to not work properly. This is an effect caused by the custom wave hack and not related to the operation of this plugin, nor can it be fixed by it.

XMB font randomizing

Same as gameboot, only for the fonts you want to use this folder on your memstick: /PSP/FONT/

Warning: Placing an improper ltn0.pgf replacement (i.e. a proper font file) in there will cause the PSP to display the BSOD on boot. If you get the BSOD when booting up, just delete any non proper font file and everything will be fine again!

Compatibility

Tested by the author on PSP Slim with 3.60 and 3.90.

Changelog

UPDATE 1.20

• Added option to disable PTF changing/randomizing.
• Added randomizing/changing of the gameboot.
• Added randomizing/changing of custom XMB waves (system_plugin_bg.rco).
• Added randomizing/changing of XMB font.
• Added file extension filter for scanning directories.
  • i.e. it will now only fetch .BMP for wall-/wavepapers, .PTF for themes.
  • and so forth....

UPDATE 1.14

• Fixed some lockups during start.
• Fixed another conflict with wavepapers in "Once per day" mode.
• Added PTF changing/randomizing.
• Added two PC based (Windows) tools for making propper 01-12.bmp replacements (background behind XMB waves) and perfect 480x272x24 PSP wallpapers you can then use with the Wallpaper-Changer.
  • Both tools take various image formats in any possible resolution as source images and should make most converting tasks very easy (two mouseclicks, and you're set).

UPDATE 1.10

• Added capability of changing/randomizing the background BEHIND the XMB wave lines (WITHOUT touching the flash0:! So, perfectly safe). Read the notes about this in the readme when having trouble with it.
• Wallpapers are now finally copied BEFORE the XMB loads, so you see the change imediately, not at the next reboot.
• Major internal changes (making the plugin pure kernel mode and dealing with the consequences), the usual bug hunting and some cleaning up of the code..

External links

• QuickJump - http://forums.qj.net/psp-development-forum/132296-release-wallpaper-changer-randomizer.html