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
Now find $PATH, and add ":/usr/local/bin/python" at the end of the line. If $PATH doesn’t exist, go to bottom of the file and add
Now Save and type STEP 4: Exporting and Editing .artwork files
Windows: Run Command Prompt as Administrator and enter
Mac: Open terminal and enter
NOW BEFORE DOING ANYTHING WITH THE .artwork FILE, CREATE A BACKUP ON iDevice AND COMPUTER
Windows & Mac: enter the following command but read the detail below first.
READ THE DETAILS BELOW
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
Mac: Open terminal and enter:
Windows & Mac: enter command but read details below first.
READ THE DETAILS BELOW:
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)