Your favorite Apple, iPhone, iPad, iOS, Jailbreak, and Cydia site.
Skinning / Themes Discussionforums, a part of the
Design and Media For the iPhone / iPod Touchsection;
02-06-2012, 06:07 PM #1iOS .artwork File Extractor Tutorial (Theme w/o Winterboard!)
This is a tutorial on how to theme UIImages WITHOUT Winterboard. (Mac and Windows support)
First of all, I'll explain what this is all about. This tutorial explains in detail how to modify the main .artwork file on your iDevice. This .artwork file is loaded with images that make up the UI (User Interface, so graphics) of your iDevice. With this tutorial you learn how to access these images in the .artwork file, so you can modify them. Then you recompile the .artwork with your new "themed" images, put the file back into your iDevice, reboot, and boom you have a customized UI without Winterboard. The advantage of this is that there is NO LAG whatsoever but you need to be CAREFUL when modifying the images because they need to remain the same size and dimension.
You’ll be using the following tools:
Pillow 2.0.0 (PIL)
iOS Artwork Extractor by developer Dave Peck
OpenSSH available from Cydia
SSH Client recommended: Windows: WinSCP, Mac: Cyberduck OR
iFunBox (Windows and Mac, download the NEWEST ONE)
Command Prompt/Terminal for entering python commands.
The .ARTWORK extractor works on iOS 2 - 6. It’s been tested personally on my iPod 4G and iPhone 4 and by others on other devices. According to Dave Peck it works on most .artwork files including, Shared, Shared@2x, Keyboard-Emoji@2x, GameKit@2x etc, EVEN Shared~ipad and Shared@2x~ipad. For this tutorial the [email protected] will be used for examples because it’s the most common out of all of the .artwork files. To read more about Dave Peck's extractor click HERE.
Overview: Gets needed tools, SSH into iDevice and get a .artwork file from /System/Library/Frameworks/Ulkit.framework/ and copy it to your Computer. Use Dave's Extractor to extract the files within the .ARTWORK file, edit the extracted files and then recompile them and put it back into your iDevice.
STOCK iOS 5 and 6 .ARTWORK FILES DOWNLOADS AT THE BOTTOM OF THIS POST!
STEP 1: Getting the Tools
Download and Install OpenSSH from Cydia. (Search: “OpenSSH”).
Download and Install a SSH Client (Windows: WinSCP, Mac: Cyberduck) OR iFunBox.
Download and Install Python 2.7.x install to the default location.
Download and Install Pillow for the link provided.
Download iOS Artwork Extractor by clicking the "Downloads" button and select download as zip. Open the folder "davepeck-iOS-artwork-xxxxxx" inside and extract all its contents to your Python installation folder (default Python Installation folder is C:\Python27 for Windows and /usr/local/bin/python for Mac).
STEP 2: Getting the .artwork file(s)
Using your SSH Client or iFunBox, go into /System/Library/Frameworks/Ulkit.framework/ in your iDevice. Copy a .artwork file onto your Desktop (Main file is [email protected] for Retina iDevice and Shared.artwork for non-Retina iDevices).
STEP 3: Editing Environment Variables/bash_script
Windows 8, 7 and Vista: Open start menu and search "environment variables" and click the first result. If Variable “Path” is already there, select it and click “Edit” and add “;C:\Python27” and close the window. If not, click "New..." and for Variable Name put "Path", for Variable Value put "%PATH%;C:\Python27" then click “Ok” and “ok” again.
Windows XP: Everything is the same except you need to right click My Computer in the start menu and click properties. After this click "Environment Variables" and continue using the instructions above.
Mac: Open terminal and type
cd ~/ edit .bash_script
PATH=$PATH:/usr/local/bin/python export PATHCode:
Windows: Run Command Prompt as Administrator and enter
Windows & Mac: enter the following command but read the detail below first.
python iOS-artwork.py export -a \path\to\artwork_file.artwork -d \path\to\export_directory\
"\path\to\artwork_file.artwork" means write the directory or place where you have the .artwork file saved and the "artwork_file.artwork" means write the name of the .artwork file (e.g. "C:\artwork\[email protected]").
"\path\to\export_directory\" means enter the path of the place where you want the extracted .png files to go (e.g. "C:\artwork\pngs\" )
Remember, the edited .png files need to have the same dimensions and size as the originals to work properly.
STEP 5: Importing and Testing
Windows: Open Command Prompt as Administrator and enter the command
python iOS-artwork.py create -a \path\to\original_artwork_file.artwork -d \path\to\import_directory\ -c created_artwork_file.artwork
"\path\to\original_artwork_file.artwork" means path to the original .artwork file (e.g. C:\artwork\[email protected]).
"\path\to\import_directory\" is the path to the place where you have all the .pngs that will be created into the new .artwork file (meaning your edited ones and the other .png files that you didn't edit)... (e.g. C:\artwork\editedPNG\ ).
"created_artwork_file.artwork" means make a name for this new .artwork file you are creating (hint make it something like Shared2@2x and then edit the name after the file is created.
The new file will be in your Python Installation directory (C:\Python27 for Windows /usr/local/bin/python for Mac).
STEP 6: Finishing Up
Now you are done, just place the new .artwork file into /System/Library/Frameworks/Ulkit.framework/ (replacing the original). BTW keep the original .artwork file in that directory too (name it ___OLD.artwork), in case you can’t get into your phone. Keep both original and edited .artwork files on your PC too.
Thanks for reading, hope this helped you. I am not responsible for any problems that arise due editing your .ARTWORK files and EDIT THESE FILES AT YOUR OWN RISK. Please leave suggestions, questions and if i made a mistake, point out errors. Thanks,
Good Luck :D
Stock iOS 6.1.2 .artwork files:
Stock iOS 5.1.1 .artwork files:
AssistantMic (iPhone 4S Only)
Shared@2x~ipad (iPad 3 Only)
Shared~ipad (iPad Only)
Stock iOS 5.0.1 .artwork files:
AssistantMic (iPhone 4S Only)
Shared~ipad (iPad Only)
Special Thanks to:
Dave Peck (for Extractor and support), elementalgodz11 (for AssistantMic.artwork fix and other contributions), Christoph Gohlke (for Python extension packages), Jato_BZ (for AssistantMic.artwork contributions, Shared@2x~ipad, other contributions AND for being a motivation), MilkyTech (for modded .artwork files and idea to upload stock .artwork files), Capp (for all those .artwork files, bearing with my impatience and putting in time to help out)
Last edited by CrAcKzZZ; 03-27-2013 at 03:03 PM. Reason: iOS 6 Stock .artwork Files!!! ahhhh!
The Following 40 Users Say Thank You to CrAcKzZZ For This Useful Post:
Alfroggy (12-27-2012), Bacardi85 (02-22-2014), Bellcross (02-26-2013), bjbinc (07-06-2012), bk_763 (02-12-2013), BoubakAy (03-02-2013), cukhiem (06-18-2013), Dacal (03-29-2013), Daniel0592 (03-10-2013), dsg (06-07-2013), elementalgodz11 (02-29-2012), EmmaJhonsson (04-13-2013), EricB78 (04-23-2013), FringeMän (04-09-2012), GPowere36 (02-28-2013), GUNNY29 (05-25-2012), iskariotA (08-30-2012), izzi (03-18-2014), Jahooba (05-28-2012), Jato_BZ (08-12-2012), jayjOka (08-17-2012), King_O_Hill (04-23-2013), MastahRiz (06-04-2012), MasterCAPS (06-22-2012), MilkyTech (02-18-2012), Newbee123 (02-06-2012), nmushkin (03-16-2013), omfg59o (08-09-2013), Phatmartino (06-09-2012), phuocpeter19 (06-16-2013), rasputin007 (02-12-2012), redtide (01-30-2013), siemprelisto (04-22-2013), Sk37cH (02-10-2013), Smitbeat (09-13-2013), SpaceTime97 (03-07-2012), stratnik (01-05-2014), TCcentex (09-04-2013), ulysseleviet (03-01-2013), Zomdark (09-04-2013)
02-06-2012, 09:32 PM #2
Thank you very much for the tutorial, CrAcKzzZ.
When I run this command:
CPython27>python iOS-artwork.py export -a \path\to\Cartwork\[email protected] -d \path\to\Cnewartwork
I got this error:
python: can't open file 'iOS-artwork.py': [Errno 2] No such file or directory
I know that the file "iOS-artwork.py" is not in Python27 folder.
My question is that how can I get iOS-artwork.py?
Thanks again for great tutorial.
02-07-2012, 03:09 PM #3
Go to this link https://github.com/davepeck/iphone-t...er/iOS-artwork and click "Downloads" and download as zip, open the folder inside and extract components to your Python Installation folder. I guess missed that part in the tutorial :P
02-07-2012, 03:48 PM #4
The Following User Says Thank You to Newbee123 For This Useful Post:
02-07-2012, 06:03 PM #5
No problem man, i like to help out as much as i can . Btw there may an official tutorial coming out for this extractor which would be cool :P Also i think i need to work on the mac instructions, dont know much about how to work with Mac Environment Variables. Any idea what your gonna do after you extract them? i put together a clean Black version of the original UI, found no problems importing so far :P
02-07-2012, 08:02 PM #6
Yeahhhh, I got it. Unpack and repack without any problem.
Now, I can mod my i4s without using winterboard.
Million thankssssssss, CrAcKzZZ. You know what, it took me almost a month just try to change the color signal bar. With your help, now, I got it. I'm really appreciate that Bro.
02-12-2012, 04:19 AM #7
I followed this, but found that the PIL (Python Imaging Libraries) would not install as it could not find Python on my Windows OS.
The reason was that I installed the Python-64bit version on my Windows7-64, but the PIL are 32-bit only.
So uninstalled Python-64 and installed Python-32bit, now the PIL would install.
Now it works perfectly fine.
Last edited by rasputin007; 02-12-2012 at 04:33 AM.
02-15-2012, 08:13 PM #8
No problem guys, im glad i could help out . Also im starting to dual boot my Win 7 and Mac OS X Lion and ill try to update the amc instructions. @Newbie123 LOL after i extracted the file i used Photoshop and edited was mad sooo much easier :P
02-15-2012, 08:52 PM #9
yea no problem stahlpaz, tell me if you need anything else
02-16-2012, 09:42 AM #10
It would be awesome if someone really smart would compile a gui for this :-)
Still I am going to give this a shot today [fingers crossed]
02-16-2012, 09:24 PM #11Sick!
Oh HELL Yeah!! that worked beautifully. iOS 5.0.1
Finally able to customize my statusbar icons
Thanks a million to CrAcKzZZ
Thanks to DavePeck
Thanks to the Python Software Foundation
02-18-2012, 09:17 PM #12
Congratz took me sometime to pull up all this info so im glad this helping other
02-20-2012, 12:11 PM #13
can some one help please having bother
cPython27>export-a cart\UIKit.framework\Shared@2x~iphone.artwork -d cartwo
'export-a' is not recognized as an internal or external command,
operable program or batch file.
cPython27>Python iOS -artwork.py export-a cart\UIKit.framework\Shared@2x~iph
one.artwork -d cartwork\pngs
Python: can't open file 'iOS': [Errno 2] No such file or directory
cPython27>Shared@2x~iphone.artwork export-a cart\UIKit.framework\Shared@2x~i
phone.artwork -d cartwork\pngs
'Shared@2x~iphone.artwork' is not recognized as an internal or external command,
operable program or batch file.
cPython27>Shared@2x export-a cart\UIKit.framework\Shared@2x~iphone.artwork -
'Shared@2x' is not recognized as an internal or external command,
operable program or batch file.
The Following User Says Thank You to ProfessorJack For This Useful Post:
02-21-2012, 11:26 AM #14
if you install Python 2.7.2, by default it will be on the root of your c drive. make sure it is the 32 bit version, the first one on the python download page: Python 2.7.2 Windows Installer (Windows binary -- does not include source). then install the PIL Python Imaging Library 1.1.7 for Python 2.7 (Windows only). Then dowload DavePecks iPhone tidbits and copy the contents of the iOS-artwork folder to the python installation folder. Then create a folder for your extracted artwork (i put mine inside the python27 folder and called it "extract@2x" since the file you want to extract is [email protected]k. the other .artwork files are kinda useless). then I like to place the original .artwork file to be extracted inside a folder called "orig" inside the Python27 folder also. Then you are ready to go. open the Start menu in windows and then Run. if you don't see Run, then you need to go to the start menu properties and customize and put a check next to Run. when you get the Run window open, type cmd to bring up the windows command prompt window. then start your command line instructions. get into the python directoryCode:
c:\Python27>python iOS-artwork.py export -a \Python27\orig\[email protected] -d \Python27\extract@2x
c:\Python27>python iOS-artwork.py create -a \Python27\orig\[email protected] -d \Python27\extract@2x\ -c Shared@2x_mod1.artwork
Sorry for basically regurgitating most of crackzzz's tutorial, but sometimes you just need to hammer the point home!
Last edited by MilkyTech; 02-21-2012 at 04:10 PM.
02-21-2012, 02:02 PM #15
Here are a couple of completed mods if anyone wants them:
Orange Statusbar icons plus more
Pink Statusbar icons plus more
Put the pink on your girls phone and she will do things for you that you never imagined possible
unrar and use the READ ME.txt files for instructions on where to copy the files to.
iPhone 4 cdma iOS 5.0.1
Last edited by MilkyTech; 02-21-2012 at 02:05 PM.
02-26-2012, 08:40 PM #16
02-27-2012, 09:09 PM #17
I edited the OP hopefully its more easier to read now, all suggestions are welcome
02-29-2012, 02:12 PM #18
Thank you so much CrAcKzZZ for posting this awesome tutorial. I have read so many guides but found them confusing or hard. I have probably been trying to figure this out for over 8 hours. But with this it took me 30 minutes and bam.
Any idea what I need to modify using an iPhone 4 iOS 5.0.1 though?
I have 4 files - [email protected]k, Shared.artwork, Shared~iphone.artwork, Shared@2x~iphone.artwork
Which ones would I need to modify for everything to apply?
Spoke too soon:
Using a custom UI Revamped Theme.
Last edited by elementalgodz11; 02-29-2012 at 02:36 PM.
03-02-2012, 12:54 AM #19
I followed the exact tutorial but whenever i hit enter to execute the extract command all i get is a bunch of stuff telling me what -a and -d and all that stuff means
03-02-2012, 05:29 PM #20
Last edited by CrAcKzZZ; 03-02-2012 at 05:31 PM.