Hi everyone,
I was helping some other people in another thread on how to get a wallpaper cycler that cycled wallpapers every [insert request here] hours, so I decided to make a customizable theme and release it!
I've tried to optimize and compact the code as much as I could so it uses as little CPU (and therefore battery) as it can - though I don't think it uses that much CPU power to begin with.
Note, this DOES NOT include any wallpapers - that's for you to include!
Now, I've attached two choices:
Time-based changer
This changes your wallpaper based on...you guessed it...the time! It's like the Beach wallpaper pack on Cydia, only without the wallpapers. What's new in this version, though, is more customizability! You insert more wallpapers and have it change x times per hour, rather than only once!
Random changer
This just cycles through your wallpapers randomly every few minutes (you can specify how long). The lockscreen changes every time you lock your phone. The important thing here is that you MUST edit the configuration.
js file included in the pack every time you add a wallpaper to update how many total walls you have.
What's included
Each wallpaper changer pack should include:
- A "Wallpapers" folder - this is where you put all your wallpapers
- A "Lockscreen" folder - this is where you put all your lockscreen backgrounds
- A LockBackground.html file - this manages your lockscreen background. Delete if you don't want a custom lockscreen background.
- A "Wallpaper.html" file - This is your wallpaper background. Delete if you don't want custom wallpapers.
- A "configuration.js" file - This is the MOST IMPORTANT FILE! You must edit this file (right-click>>open with>>notepad) to change the settings!
What's not included
WALLPAPERS!
General Instructions- Unrar the file to a folder of your choosing.
- Open the file you just unrared (it says .theme, but that's just a folder with .theme at the end of the name :P).
- Open configuration.js using Notepad (Right-click>>Open With..>>Notepad)'.
- Configure to your choosing (make your you look through all the settings; there's not much!).
- Delete Wallpaper.html or LockBackground.html if you don't want either the wallpapers or the lockscreen backgrounds.
- Populate your Wallpapers and/or Lockscreen folders with your pictures. These pictures should be named starting from 1.jpg all the way to however many wallpapers you need.
- SSH the ENTIRE .theme folder into your Themes folder on your iPhone (/Library/Themes)
- Select in Winterboard
- Enjoy (But read on for package-specific instructions!)
Random-Specific Instructions
You must ABSOLUTELY remember to change the WPNUM setting in your configuration.
js after you add a wall, or else it won't show!
Time-Specific Instructions
Don't forget to populate your Wallpapers folder with enough wallpapers to cover the WHOLE 24-hour period, or else you'll just get a black background. The number of wallpapers you need is represented by the formula, 24*(60/MINUTES_PER_CHANGE).
For example, if I set MINUTES_PER_CHANGE to 15, I would need 24*(60/15) = 24*4 = 96 total wallpapers (wallpapers numbered 1.jpg - 96.jpg). Of course, if you don't have enough, you can always duplicate your wallpapers and name them differently.
Other Notes
If you want the same pack of wallpapers for both your lockscreen AND your wallpaper (save some space!), you can set either the lockscreen source folder or the wallpaper source folder in your configuration.
js, using WALLPATH or LOCK_WALLPATH. For example, I could set WALLPATH = "Lockscreen/", so that all my wallpapers will also be taken from the Lockscreen folder (same folder as the lockscreen walls). Remember, folder names are CaSe-SeNsItIvE!
Don't forget you can change your image type. I use PNG images, for example, so in my configuration.
js file, i would set both IMGTYPE and LOCK_IMGTYPE to "png". However, you have to use the same file type throughout.
I'd release my own set of wallpapers, but none of the walls were made by me and I'm not sure how the original authors would feel. I CAN tell you, though, that there's a nice wallpaper repository here on modmyi, and also
here. You can check out
Vlad Studio as well for some amazing art, but you'll have to crop them manually as they're made for PC.
That's all, and don't forget to give me some feedback or report any bugs!
10-24-2008, 10:15 PM
Linear Mode
