Customising the Buuf2 Winterboard Theme



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:


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/

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/

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/, 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/ Copy the file SpringBoard.strings from Buuf2.theme/Bundles/ 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!

Tags: , ,

12 Responses to “Customising the Buuf2 Winterboard Theme”

  1. Buuf - Page 87 Says:

    […] currently spread throughout the thread – I’ve written a bit of a guide on customising Buuf2. Check it out here and let me know what you think – I’ll keep an eye on this thread, and if I see any new useful info […]

  2. m3ta1he4d Says:

    great customizing guide dude! keep it up.. i love buuf2! we all do.. 8)

  3. s. Says:

    Thank you so much! Motivated me to make 3 SBSettings Icons for Location, iPod and Processes which I didn´t found in that russian SBSettings Theme. If someone is interested in just let me know by commenting in this thread.

  4. iPhone Screen Shot Thread II - Page 22 - Says:

    […] structures for my apps? I love Buuf2, to keep up to date with new icons first of all read my guide, and then use the thread on modmyi to request any icons you can't sort out […]

  5. Creating Your Own Buuf2 iPhone Icons « Petescrap Says:

    […] Your Own Buuf2 iPhone Icons By petescrap Following on from my post on customising the iPhone Buuf2 theme, I thought it was about time somebody wrote up some instructions on how to create new icons from […]

  6. Osner Says:

    I felicitate you for such a comprehensive good article.
    However, I just upgraded my buuf2 theme to the latest 4.0 version
    and I realized how much I prefered the last version
    instead. Is there a way I can get back the old version ?please let
    me know. What is the website for buuf2 creators arts ?

    • nada Says:

      i have the full complete buff theme for iphone 3gs version 3
      send my an email to post it in mediafire so that you could download it
      if u r still intrested 🙂
      i really love this theme it’s amazing…

  7. nada Says:

    hii there i really love your work and all the buff themes and it’s used to be my tracker when i build my themes and all my themes work fine and they where full complete ones . but i did’t post them to cydia ,
    now after i updated my iphone 3gs to version 4.3.3 now the theme is not working well (loading screens , keypad lock screen only when i pressed the buttons it’s shows) so what can i do what are the new path i put other than “” before the updating it was working perfectly
    so can you help me please

  8. Z Says:

    It doesn’t work for me!! My twitter and whatsapp doesn’t work! I tried deleting the twitter ready-made in the icons folder. Don’t work as well.

  9. callouspenguin Says:

    i have a question. i have the buuf2 additional icons.theme on my winterboard, why do only some change the icons? for example; ifighter changes, but dig dug remix didn’t change even though there is a icon to change it? same thing with crystal defenders, it changes to a crystal, but street fighter 4 stays as the original app icon when there is a icon to change it. am i doing something wrong? i put the additional icons theme above buuf2 on winterboard, still nothing. please help.

  10. please help!! i want to change my iphone icons Says:

    […] […]

  11. custom icons for buuf2 Says:

    […] into another folder and re-name them but that hasn't worked. here's the link to the tutorial Customising the Buuf2 Winterboard Theme | Petescrap iphone4 + ios6.1 Reply With […]

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: