Posts Tagged ‘Winterboard’

Customising the Buuf2 Winterboard Theme

January 27, 2009

lockscreen

springboard

If you’re reading this, you’re probably already using Buuf2, the most distinctive, characterful theme available for the iPhone. Buuf2 is based on the icon set created by mattahan (see his deviantart page here), and was formatted for the iPhone by axero (see the modmyi forum thread here).

The purpose of this guide is to assist you in customising Buuf2 to your liking. Since the release of firmware 2.0 and the AppStore, the number of apps available for the iPhone has exploded. Trying to keep pace with the number of icons required would be a Herculean task; thankfully, modmyi users nmilsaps and golum have stepped up to fulfil many icon requests on the official thread, and axero incorporates their efforts into his updates when he gets a chance.

However, we are seeing an awful lot of icon requests that are repeats, or where there is already a perfectly suitable icon to use. I’m not going to put anyone down for this, though – it’s a measure of the popularity of this incredible theme. What I would like to do is to provide a little guidance on customising the icons yourself, in the hopes of taking some off the load off the theme creator and the guys on the modmyi forums – and to improve the Buuf2 user experience for all!

Icons is going to be the first and most important part of this guide – but I will get to other topics too, such as system graphics, sounds, wallpapers and so on.

Right, so you downloaded a new app from the AppStore, and now you want it to stop sticking out like a sore thumb on your springboard by applying a proper Buuf2-style icon. Well, the first thing you need to realise is that there probably already is one! Let’s go take a look. SSH into your iPhone, and navigate to /var/stash/Themes.xxxxxx/Buuf2.theme (the xxxxxx part will be different for every iPhone). See the Icons folder? I recommend you copy that to your PC. While you’re here, create another folder called Buuf2 Custom.theme, and create an Icons folder in there. This is where we’re going to put our custom icons.

Now that you’ve got the Buuf2 icons on your PC, have a browse through them and see if there’s an icon that suits your new app. There are over 750 icons at the time of writing (though many of them are repeats), and I’m willing to bet there’ll be something in there that will fit the bill, even if it’s not exactly what you were looking for. Got one? OK, now make a copy of it, and rename it with the exact app name that shows on your springboard. Copy the new icon into the icons folder in the Buuf2 Custom.theme we created.

OK, now on your iPhone, launch Winterboard. You should see that as well as Buuf2, you now have a Buuf2 Custom theme in the list. Drag it up the list so that it is above Buuf2, and select it so that it has a tick against it, like so:

Winterboard

Now, respring, and you should see your new icon! That was easy, eh?

At this point, a quick note on why I choose to create a Buuf2 Custom theme, rather than just placing custom icons in the existing Buuf2 theme. If you modify the existing theme, then when the official package on Cydia (or Installer – blech 😉 ) gets updated, the update will overwrite any changes you made. My way, you get to keep your own custom icons – plus whatever other customisations you may wish to make.

Alright, now what if you didn’t find an icon you liked enough in the existing icon set? OK, OK, I’m willing to admit this can happen. There are some pretty off-the-wall apps around, so it is always possible you couldn’t find one that suited well enough. Well, don’t worry just yet – there are a couple of things you need to check out before you post an icon request on the forum thread.

First, was there an icon that almost, but not quite, did the job? Or a couple of icons which, if combined, would be ideal? If so, post details with your icon request. It will save the guys with the icon-editing skills a lot of time if you give them something to work from.

Second, check out mattahan’s complete Buuf icon set (see here). Download it to your PC, extract the icons, and get browsing! Not everything from the full icon set has been ported to the iPhone version – yet. Again, if you find one you like, post details with your icon request and someone will convert it for you. (If you’re feeling brave, you can have a go at converting the icon yourself – any decent image editing program, such as Irfanview or GIMP, can re-size the image to the 60×60 pixels required for the iPhone springboard. However, the results may look a bit jaggy – I certainly don’t have the skills yet to make it look good enough!)

Thirdly, you can always – gulp – browse the thread on modmyi. Yes, I know it’s long, and people hate to search for stuff ;-). There’s a quick way to see if an icon has already been posted – in the New Skins / Themes Launches forum, click on the little paperclip by the Buuf2 thread – this will bring up a list of all the attachments (see below).

Buuf2 thread - view attachments

I tend to keep an eye on the thread, and any time an interesting-looking icon pops up, I save it for future use if necessary. You never know when you’re going to need a Buuf2-style barfing smiley icon.

Finally, you can have a go at creating an icon yourself. Now, you can’t just edit the icons in Paint you know – they have a transparent area, and Paint just screws that right up. So, you’ll need a ‘proper’ image editor. Luckily, there’s a free one that works well and won’t screw up the transparent areas – GIMP. There’s even a portable version you can install to a USB stick, so there’s no reason not to use it unless you have access to something more professional, like Photoshop (I don’t). Using GIMP, you can open up the icons, copy bits from one and paste them onto another, and generally mash things around until you have something that hopefully looks something like what you wanted, and not just a great big mess ;-). Again though, even if you’re not happy with your results, it can serve as an invaluable example for an icon request – “make a version of this that doesn’t suck, please!”. For some more detailed info on icon creation, nmilsaps posted some tips in the thread here and here.

OK, that’s about it for icons – here are a few extra tips on customising other aspects of the interface!

How to change the ringer volume level icons: put these into Buuf2 Custom.theme/Bundles/com.apple.springboard/


When launching the dialer, you may sometimes see a keypad screen with German text on it pop up briefly. This is just a loading screen – to change it to an English one, place the copy SIckbrain provided into Buuf2 Custom.theme/Bundles/com.apple.mobilephone/.

BiteSMS Buuf Balloons

SBSettings theme (I couldn’t get this to work terribly well with my setup, but I’m sure golum will update it).

Changing system sounds: I find the chime the iPhone makes when you plug it in too loud, when I’m coming to bed after my wife and dock it I’m always worried it’ll wake her up. So I changed it to make it quieter. Using Audacity (well, Audacity portable actually), I opened up the file Buuf2.theme/UISounds/beep-beep.caf, reduced the gain to -12dB or so, and saved it as a .caf file (note: to save as a .caf, go to Edit > Preferences > File Format tab, and change Uncompressed Export Format to CAF (I used 16 bit PCM). Put this file in your Buuf2 Custom theme, and hey presto, quieter charging tone!

Custom sliders: I have to say I’m not a huge fan of the Buuf2 slider icons. There’s a really cool slider theme on Cydia called Zipper Sliders (I think), however unfortunately it wasn’t working properly – I think something in the folder structure changed post-firmware 2.0, and the theme wasn’t updated properly. However, if you install the non-working theme, and copy the zip icons (can’t recall which folder they’re in, sorry) into Buuf2 Custom.theme/Bundles/com.apple.TelephonyUI, you’ll get the zippers I use. You can then un-install the non-working zippers theme.

How to change the text of the unlock-slider: create the folder path Buuf2 Custom.theme/Bundles/com.apple.springboard/en.lproj/. Copy the file SpringBoard.strings from Buuf2.theme/Bundles/com.apple.springboard/en.lproj/ into your new folder and double click the SpringBoard.strings file to edit it. When it opens in notepad, just change Buuf2 to whatever you like.

Some Russian users have packaged up a very comprehensive version of Buuf2, which skins just about everything – calendar, AppStore, Cydia, iPod, and so on. I like to keep my themes to the springboard really, so I haven’t applied it myself, but it does appear to have been very well done. You can get it here.

Wallpapers: Buuf2 has such a distinctive style, it’s kinda hard to find wallpapers that suit it well. You could do worse than to check out some more of mattahan’s excellent work on his deviantart page, of course 🙂

EDIT: I really should give credit to Hack That Phone for this excellent Winterboard tutorial, that taught me most of what I know about customising themes!

Advertisements