How to Submit an Icon Request
Before all icon requests, do the following:
Search for the app name in the issue tracker.
If it exists, add a comment describing what you think the problem is to the existing issue. If the issue is currently closed, don't worry; if necessary, we'll reopen it.
If Check For Existing Issues doesn't find anything, use Github's file finder, Type in the name of an app to see if it
exists.
If the icon exists, but you think there's a problem with the current icon, fill out a New Icon Request, add a separate comment to the issue you just created letting us know what you think the problem is.
If you have any additional information, such as how to fix the issue, we would be grateful if you'd supply that.
If you still can't find the item, you are now able to fill out a typical New Icon Request. Only 1 icon request per issue. Issues with multiple icon requests will be closed.
While we've tried to make this as simple a process as possible, tracking down all the information needed for an icon request is not for the faint of heart. Please read everything below before continuing.
If your request does not meet our requirements, it will be closed.
If the icon has not already been requested, enter an issue title with only the name of the application, such as:
Find My Friends
Do not enter anything like the following:
Requesting Find Friends!!!!1!!ZOMG I would <3 you forEVAH if you did this one! :)I can't Find My Friends! Can you help!?!?!?URGENT!! YOU MUST DO THIS FOR ME OR I'LL DIE OF DYSENTERY!
How do I find the exact name of my application? Use the Name value
from Step 2
We have made great strides in making this as painless a process as possible. If you follow the exact steps outlined below, you will have a valid request. However, if you do not give us an icon request in the exact format we're looking for, your request will be closed.
This is important because if we need to go back and run an automated script to parse all of the issues and put them into a database, we need them to be consistently formatted. Thank you for your cooperation.
Because it's quite complex, it may be easier if we show you what a properly executed icon request looks like.
The easiest way to find all of the metadata we need is to download AppInfo from Cydia.
Open AppInfo and choose the app you're requesting an icon for. Example:
Locate the line that says Item ID. That is the iTunes ID and it will be used in the
next step.
What do I do if the Item ID is blank?
- Open this page in a new tab.
- Enter the iTunes ID you acquired from Step 1 in the field provided.
- Press "Grab data!"
Assuming the iTunes ID is valid, you'll see a page with a text field and (hopfully) a big image of the artwork. No worries if the image looks like the link is broken - sometimes iTunes provides only a .tif-image wich can't be shown by all browsers.
Copy the entire contents of the text area - as it is - and paste it into the issue you've opened.
It is VERY important that you paste it at the very top of the icon request.
Once you've done that, there will be two lines that will not be filled out yet.
iPhone Icon Name: ### THIS IS FOR GLASKLART MAINTAINERS DO NOT CHANGE THIS LINE ###
and
Icon Names: ### PLEASE FILL THIS OUT ###
You're now ready for the final step.
Go back to AppInfo to your app and locate the entry for IconFiles.
Take this entire line and exactly copy it onto the Icon Names line from
Step 2. For RunKeeper, the line would go from this:
Icon Names: ### PLEASE FILL THIS OUT ###
to this:
Icon Names: Icon.png | [email protected] | Icon-72.png | Icon-Small.png | [email protected]
What do I do if IconFiles is 'Unknown'?
Hit 'Submit new issue' and we'll verify your request as soon as possible. Thanks for helping to make Glasklart even more awesome!
If AppInfo tells you that IconFiles is 'Unknown', scroll down to the bottom
of that screen and tap 'Open in iFile'.
Once iFile opens, in the list of files should be a folder with the name of
your app (in the above example it would be RunKeeper.app). You'll want to
tap on that folder.
In the folder that opens, you'll see a long list of files. You're looking for
one called Info.plist. Tap on that.
iFile will ask you what you want to open the file with. Choose 'Property List Viewer'.
When Property List Viewer opens, scroll down until you find an entry called
CFBundleIconFile. The value on the righthand side is what you will enter for
the PNG Icon Name when creating your icon request.
The only reason we've found for AppInfo to have a blank ItemID field, is
if you've pirated the app. We don't condone piracy, but occasionally an app
must be installed outside of the App Store ecosystem. For example, if it was
pulled from the store, or the newest version has a bug that makes it unusable.
In those cases, to find the iTunes ID you'll want to:
- Open the iTunes Store
- Navigate to the app you want to make a request for
- Right click on the name of the app
- Choose "Copy Link"
- Paste the link somewhere and look at it
The link will look something like this:
https://itunes.apple.com/us/app/runkeeper-gps-track-running/id300235330?mt=8
The iTunes ID is everything after the 'id' and before the '?'. In this case:
300235330
To view an example icon request with all the necessary information, view issue #1297.