ThemePlus! NX v3.01 for 3.71 M33-2
----------------------------------

Changes
-------
- Fixed a major bug that locks up the PSP when no custom themes and/or wallpaper and/or gameboot file found. So this should work 100% now on Original and Slim PSP running on custom firmware 3.71 m33-2.
- Included the DEBUG version (see FAQ for more info)
- Included the binary and source code of ThemePlus! NX v2 for 3.52 M33-4 (this was before the code was re-written from scratch for 3.71 M33-2)

Introduction
------------
This plugin allows you to change your PSP's Custom Theme, Wallpaper and/or Gameboot randomly and timely.

You can set the option to change them:
  * Always - Changes the PSP's Custom Theme, Wallpaper and/or Gameboot everytime the XMB loads up
  * Hourly, Daily, Monthly, and Yearly - Changes the PSP's Custom Theme, Wallpaper and/or Gameboot on the next hour, day, month, and year the XMB loads up
  * Disable - Don't change the PSP's Custom Theme, Wallpaper and/or Gameboot at all

You can use any quantity of custom themes, wallpapers and gameboots and you have the option if you want the plugin to search for wallpapers and gameboots inside the sub-directories.

NOTE: If preset is enabled, there's a 50% chance that a preset file will be used. If preset file is used, the settings from preset file will be used instead from the config.ini.

Important
---------
- This plugin has been optimized carefully enough to get rid of the delay.
- Some of the settings that was previously marked as "(not working yet on V3.00)" has been removed due to different compatibility from Original PSP and Slim PSP.
- If the custom theme doesn't change, make sure that your PSP setting [Theme Settings]->[Theme] is set to [Custom Theme]
- If the wallpaper doesn't change, make sure that your PSP setting [Theme Settings]->[Wallpaper] is set to [Wallpaper]
- If the gameboot doesn't change, check the FAQ #4 below
- Configuration file is located at 'x:/seplugins/themeplus/config.ini' (where x is your PSP drive) 
- Sample preset file is located at 'x:/seplugins/themeplus/presets/' (where x is your PSP drive) 
- Custom Themes accepted by this plugin are .PTF files
- Wallpapers accepted by this plugin are .BMP and .JPG image formats
- Gameboots accepted by this plugin are .PMF formats

FAQs
----

Q #1: What firmware version does it run?
A #1: 3.71 M33 and 3.71 M33-2. Although I recommend you to upgrade to 3.71 M33-2 since 3.71 M33 has a nasty bug w/c got fixed in 3.72 M33-2.

Q #2: Does it work on Slim PSP?
A #2: [UPDATED] Yes it now should! The major bug has been fixed that made this 100% compatible to Original and Slim PSP.

Q #3: How do I know if the plugins works successfully or not?
A #3: Open the file to 'x:\seplugins\themeplus\themeplus.log' (where x is your PSP drive). From there you'll see if the plugin encountered any problems or if it ran successfully.

Q #4: I get "Error: Unable to create/overwrite the resource file 'flash0:/vsh/resource/gameboot.pmf'! (-2147352254)"
A #4: This will occur if your gameboot file is in read-only/hidden attribute. To clear the attrib, follow these steps:
	1. Connect your PSP to your PC
	2. On your PSP, activate Flash0 USB (M33 Recovery Menu->Advanced->Toggle USB (flash0))
	3. On Windows, go to command prompt (Start Menu->Run...) and type 'cmd'
	4. On Comand Prompt, type 'attrib x:\vsh\resource\gameboot.pmf -R +A -S -H' (where x is your PSP drive)
	5. Deactivate Flash0 USB (M33 Recovery Menu->Advanced->Toggle USB (flash0))
	6. Disconnect PSP from PC

	(note #1) If you're not familiar with any of the steps above, do not do any of it. Instead, get a help from the forums.
	(note #2) You'll only have to do that once per every firmware installation. 

Q #5: I get "Error: Unable to open folder 'xxx'! (-2147418110)"
A #5: Some folders you have specified in the config.ini does not exist.

Q #6: I get "Notice: ThemePlus! data file 'ms0:/seplugins/themeplus/themeplus.dat' not found.". What does it mean?
A #6: That file is generated/updated everytime the custom theme/wallpaper/gameboot is flashed. If the file is not found, the plugin will flash the custom theme/wallpaper/gameboot on the next time the XMB loads up.

Q #7: I think the plugin does not work properly
A #7: First, open the 'x:\seplugins\themeplus\config.ini' to configure your own settings. Then read the FAQ #3 to check if the plugin encountered any errors.

Q #8: The plugin encountered an error and I don't know what to do...
A #8: Post the contents of 'x:\seplugins\themeplus\themeplus.log' (where x is your PSP drive) to the official release thread so I can help you easier.

Q #9: [NEW] What is the DEBUG version included in this release?
A #9: The DEBUG version includes the DEBUG messages. This is helpful for the developer to see what went wrong while the plugin is running.

Q #10: [NEW] Should I use the DEBUG version instead?
A #10: Never since it slows down the plugin alot! Only use this if you're having an issue running the plugin. Then do FAQ #8

Q #11: You suck at making a README file
A #11: Sorry, its easier to code than to explain what it does :X

How To Use
----------
1. After extracting all the contents of ThemePlus_NX_v3_01.rar, copy all the contents of the folder MS_ROOT/ to the root of your memory stick.
2. Like any other vsh plugins, add the line 'ms0:/seplugins/themeplus.prx' (without quotes) inside the file 'vsh.txt' from 'ms0:/seplugins/' directory. If that file does not exist, copy the existing file from 'MS_ROOT/seplugins/'.
3. To change the configuration, open and edit the file 'config.ini' from 'ms0:/seplugins/themeplus/' directory.
4. Put your favorite custom theme/wallpaper/gameboot files in their respective folders based from the config.ini.
5. Enable the plugin from the M33 recovery menu.

Version History
---------------

3.01 NX
-------
- Fixed a major bug that locks up the PSP when no custom themes and/or wallpaper and/or gameboot file found. So this should work 100% now on Original and Slim PSP running on custom firmware 3.71 m33-2.
- Included the DEBUG version (see FAQ for more info)
- Included the binary and source code of ThemePlus! NX v2 for 3.52 M33-4 (this was before the code was re-written from scratch for 3.71 M33-2)

3.00 NX Beta 2
--------------
- Optimized speed! Delayed XMB load was reduced from 20 seconds to 2 seconds! Replacing Custom Theme, Wallpaper, and Gameboot at the same time is faster than replacing Wallpaper only from the previous version. Yep, you've read that right.
- Fixed some bugs on Interval not working correctly. It should work properly from now on.
- Improved compatibility

3.00 NX Beta 1
--------------
- NEW! Support for Official Sony Custom Theme (.PTF) files
- NEW! Preset files.  Create your own Custom Theme combination (Theme, Wallpaper, and Gameboot)
- Works on 3.71 M33 with Original or Slim PSP

v2.10 NX Beta 2 (10/7/2007)
---------------------------
- Support for PSP Slim

v2.10 NX Beta 1 (10/6/2007)
---------------------------
- This plugin now works only on 3.71 M33 and possibly higher versions (unless Sony change prx NIDs again)

v2.00 NX (9/30/2007)
--------------------
- Gameboot can now also be changed randomly
- Ability to change Wallpaper, Gameboot, or both
- Added an option to add images and gameboots under the sub-directories in the list
- Fixed a bug when changing the directories from the configuration file. The bug occurs when the directory's length is lesser than the original
- This has been tested on 3.52 M33-4 only and may not run yet on 3.71 due to PRX incompatibilities. I'm still using 3.52 M33-4 and may not upgrade yet until the 1.50 subset installer for 3.71 M33 is out. But this is only for personal reasons.

v1.21 (8/18/2007) - Stable Version
----------------------------------
V1.2 was rushed last night and I was too sleepy to beta tests all the functions. All unseen bugs are now fixed in this version. Sorry for the inconvenience.

- Modified how Daily, Monthly, and Yearly intervals work
  * Daily - Wallpaper now changes the next day the PSP boots up, restarts, or exited from game regardless of time
  * Monthly - Wallpaper now changes the next month the PSP boots up, restarts, or exited from game regardless of day or time
  * Yearly - Wallpaper now changes the next year the PSP boots up, restarts, or exited from game regardless of day, month, or time 
- Fixed timezone bug. There will be a slight delay increased when wallpaper is changed for the sake of timezone. Other than that, same performance when the wallpaper will not be changed
- Updated config.ini. This is a problem in v1.2.
- New 'ms0:/seplugins/themeplus/themeplus.dat' file is created everytime the psp changes wallpaper. Deleting it will reset the checkpoint that will be basis for date compare.

v1.2  (8/17/2007)
-----------------
- Added new intervals of replacing wallpaper (besides ALWAYS and DAILY): HOURLY, MONTHLY and YEARLY.
- Added option to specify Images folder manually
- Added configuration file - Config.ini
- Timezone is now loaded properly. No need to use timezone.ini.
- Optimized code to increase performance
- Bundled with Guilty Gear wallpapers

v1.01 (8/13/2007)
-----------------
- Method to change wallpaper every boot has been added

v1.00 (8/12/2007)
-----------------
- First release
- Bundled with Tekken 5: Dark Resurrection wallpapers

Credits
-------
Developed by NephilimNX a.k.a Chyros

Special Thanks
--------------
To the developers in www.ps2dev.org
To the people who've given feedbacks and suggestions from the forums that made this a better plugin
