PDA

View Full Version : Guide How to use Winterboard



MrBucket101
09-24-2008, 11:50 AM
Prerequisites:


WinSCP, iPhoneBrowser, or any other SSH utility
Know how to copy files to and from the iPhone
Winterboard - get it on cydia
This guide can be used to modify an existing theme from cydia or to create your own theme
----------------------------------------------------------------------------------------

When creating a theme first make a folder under /Library/Themes/

next we place the following items that we want to be applied inside /Library/Themes/(Your Theme)

-Wallpaper.png, 320x480

-If you would like to have a video wallpaper as your background, Wallpaper.mp4
-I believe that you can have only one wallpaper.xxx file within the theme folder, if you have two, the .png file will be used

-Dock.png, 320x90

-LockBackground.png, 320x480

-StatusBar.png (when it is dark/clear only), 320x20

-SMSBackground.png 320x375
Now there are three ways to go about skinning the icons.

-Method #1 which is my favorite is to make a folder called Icons inside /Library/Themes/(Your Theme)/

copy over the icon you want to change and make sure that it matches the name of the application you are changing

so to change the Weather.app icon, you would place a .png file inside /Library/Themes/(Your Theme)/Icons with the name of Weather.png (Capitalization counts)....the easy way to do this is browse to /Applications and look at the names of all the .app folders, these will be the respective names of the .pngs you place inside /Library/Themes/(Your Theme)/Icons/

- This method works for AppStore apps but remember the name has to be EXACTLY the same
The second and third methods are documented in post #2

The advantage to the second and third method is that they allow you to replace ANY icon inside the respective apps folder, not just the icon. This allows you to also theme applications as well as the springboard. For more information skip to post 2

----------------------------------------------------------------------------------------------------
Also i have a backup of every png that was used by customize during the 1.1.3 and the 1.1.4 era, these are still compatible with the new firmware given that they have the right filename and the right location.

ORIGINAL CUSTOMIZE ICONS HERE (http://www.iphonemodding.com/forum/downloads.php?do=file&id=789)

------------------------------------------------------------------------------------------------------------

Resources used:
http://www.saurik.com/id/9
http://www.modmyi.com/forums/winterboard/282971-how-make-your-own-winterboard-theme-tutorial.html

For Future

Things to detail:

-UISounds - change system sounds
-UIImages
-How to change SMS bubbles, sliders, slider background and other misc little things

Things to learn how to use:

-Themeing with HTML (this will probably be a contribution from a different user, i have no need for this)
-info.plist feature

-change font color
-changing default iPhone font

MrBucket101
09-24-2008, 09:14 PM
There are also two ways of doing this. The first method, which i recommend, is what i would say the more advanced users should use. The benefit of doing this is that a nice structural order is maintained that is easy to follow and come back to modify. It also lets you target a specific application regardless of where it is located.

Method #2

The first method involves using the info.plist file located within the apps main directory.Navigate to the main directory of Weather.app (/Applications/Weather.app/. Inside the folder we will find something called info.plist, download this file and open it with your favorite text editor (I prefer Notepad++) make sure you turn on word wrap. Next search the file for the string com (Ctrl+F, type in "com"). The first thing that comes up will be the identifier of the application

http://img242.imageshack.us/img242/4974/fappleplistm77fd1cdqu3.jpg
as you can see the Weather.app' bundle identifier is com.apple.weather

Now that we have this information, simply make a folder entitled com.apple.weather inside /Library/Themes/(Your Theme)/Bundles/

after that simply place the new icon inside /Library/Themes/(Your Theme)/Bundles/com.apple.weather/ with the name icon.png
Method #3
The second way is to make a Folder called "Folders" inside /Library/Themes/(Your Theme)/

To change the Weather.app default icon you would create a folder called Weather.app in /Library/Themes/(Your Theme)/Folders/ then you would place the respective png file inside that folder with the name icon.png

MrBucket101
09-24-2008, 09:17 PM
Weather.app
/Library/Themes/(Your Theme)/Folders/Weather.app/ - OR - /Library/Themes/(Your Theme)/Bundles/com.apple.weather/

weather_day_bkgd.png
weather_night_bkgd.png
clouds.png
flurries.png
fog.png
hail.png
haze.png
ice.png
lightning.png
mini-cloudrain.png
mini-clouds.png
mini-flurries.png
mini-fog.png
mini-hail.png
mini-ice.png
mini-lightning.png
mini-rain.png
mini-snow.png
mini-snowrain.png
mini-sun.png
mini-suncloud.png
mini-sunhaze.png
mini-sunrain.png
mini-wind.png
moon1.png - moon24.png (this is 1-24)
partlycloudy.png
partlycomboclouds.png
rain&clouds.png
rain&snow.png
rain&sun.png
rain.png
snow.png
sun.png
wind000.png - wind059.png


The following are not specific applications but frameworks that you can theme, the same procedure as above is followed, I feel that they belong here.
----------------------------------------------------------------



com.apple.springboard
/Library/Themes/(Your Theme)/Bundles/com.apple.springboard/
-original png location: /System/Library/CoreServices/SpringBoard.app

com.apple.TelephonyUI
/Library/Themes/(Your Theme)/Bundles/com.apple.TelephonyUI/
-original png location: (still looking)


I am only one man, so I am going to ask for help on this one. If you would like to help please send me list (through PM) with the filenames of the respective pngs located within a folder inside /Applications/...any person who contributes to this guide will be given credit in bold blue after i paste their findings

MrBucket101
09-24-2008, 09:17 PM
until i can write my own version of how to do this...this will do for nowcredit to opusandbill @ MMi

New winterboard update 8-19-2008
Saurik has added support for changing User interface sounds.
this is were the sounds are located: /System/Library/Audio/UISounds/

Step 1: open itunes
Step 2: click Itunes, then preferences
Step 3: click Advanced
Step 4: click import
Step 5: where it says "Import Using" select AIFF encoder
Step 6: load sound to itunes
Step 7: select sound and right click and select "convert selection to AIff"
You should now have 2 clips with the same name.
Step 8: select the AIFF file click "get Info" and make note of where the file is located.
Step 9: find clip
Step 10: drag clip to desktop and rename it as the file you want to replace and changing .aif to .caf
Step 11: Add UISounds to your theme
Step 12: place new clip into UISounds folder
Step 13: open winterboard and tap your theme twice and then exit winterboard and wait for springboard to restart.

you now have a new sound.

MrBucket101
10-28-2008, 10:45 PM
Original Guide updated

check Application specific themeing section

MrBucket101
06-20-2009, 09:11 AM
In OS 3.0, the text messaging icon has been change. Instead of Text.png, you must now rename your icon to Messages.png

maXimus
06-20-2009, 09:37 AM
Thanks for the info! :cheers:

MrBucket101
06-21-2009, 12:57 AM
UPDATE:

to apply previously downloaded SMS themes

SSH with wincp or cyberduck to /library/themes/*yourtheme*/Bundles/

rename com.apple.mobilesms to com.apple.chatkit

this should fix the bubble colors.

maXimus
06-21-2009, 01:03 AM
Great find MrBucket! We may need a whole new guide!!! :D

pman860507
06-22-2009, 11:15 AM
thanks this helps a lot.

pman860507
06-22-2009, 11:31 AM
i couldnt edit my post so...

if anyone has made a complete theme how much time do you think it would take to complete it?

MrBucket101
06-22-2009, 11:32 AM
i couldnt edit my post so...

if anyone has made a complete theme how much time do you think it would take to complete it?
That doesn't make sense....care to elaborate?

pman860507
06-22-2009, 02:35 PM
making a theme from scrach how long do you spose it takes?

maXimus
06-22-2009, 03:51 PM
making a theme from scrach how long do you spose it takes?
It really depends on how many apps/items you are theming. It took me about 4 or 5 days to complete the forum's theme. The better you are at graphics designing, the faster you can do it!!

If you create a theme, let me know and we can host it on Cydia for you. :cool:

pman860507
06-23-2009, 09:24 AM
are you sure that the SMSBackground.png is still the same. becasue i noticed that the SMS bubbles moved to a different folder.

my SMS background is not showing up on my phone.

also is there a way to change your background to a differnt picture when its in landscape that would be pretty cool.

MrBucket101
06-23-2009, 10:25 AM
are you sure that the SMSBackground.png is still the same. becasue i noticed that the SMS bubbles moved to a different folder.

my SMS background is not showing up on my phone.

also is there a way to change your background to a differnt picture when its in landscape that would be pretty cool.



rename com.apple.mobilesms to com.apple.chatkit

this should fix the bubble colors.
refer to bold text

pman860507
06-23-2009, 11:40 AM
yeah im not talking about the bubbles i know where they go im talking about your SMS background. i can not get it to show up keeping it where it is.

maXimus
06-23-2009, 12:42 PM
That's strange. I hadn't heard the location changed.

pman860507
06-23-2009, 12:46 PM
That's strange. I hadn't heard the location changed.

yeah i just cant figure out why its not working. its really annoying me lol

MrBucket101
06-25-2009, 11:27 PM
yeah, alot of file locations changed...for one, the SMSBackground.png, and the keyboard bundles.

I haven't checked lately but as of 3 days ago, noone had found them