Skip to content

How to Submit an Icon Request

Günther edited this page Feb 24, 2019 · 23 revisions

Verify Icon Hasn't Already Been Submitted

Before all icon requests, do the following:

Step 1: Check For Existing Issues

Search for the app name in the issue tracker.

Search

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.

Step 2: Check For Existing Icons

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, leave a comment on the current issue letting us know what you think the problem is, we will re-open the issue to evaluate the solutions.

If you have any additional information, such as how to fix the issue, we would be grateful if you'd supply that.

Step 3: Fill Out A 'New Icon Request'

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.

10 Icon Requests

New Icon Request

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

Tracking Down Needed Information

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.

Getting Started with AppInfo

The easiest way to find all of the metadata we need is to download AppInfo from Cydia.

Step 1 of 2: Find the iTunes ID

####Finding the iTunes ID on the iTunes App Store (PC)####

Open iTunes

If your app is already on the "My Apps" tab right click on the app and click Show in iTunes Store

If not find it with the App Store search bar

Once the app's overview page is open right click over the app image and click Copy Link

You should get something like this https://itunes.apple.com/us/app/infinity-blade-iii/id610003290?mt=8

Now you have the iTunes ID, in this case 610003290 (notice is the number between .../id and ?mt=8)

Step 2 of 2: Create a Well-Formed Request

  1. Open this page in a new tab.
  2. Enter the iTunes ID you acquired from Step 1 in the field provided.
  3. Press "Grab data!"

Assuming the iTunes ID is valid, you'll see a page with a text field and (hopefully) a big image of the artwork. If the image looks like the link is broken, no worries, sometimes iTunes provides only a .tif-image which 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 one line that will not be filled out yet.

Accepted Artwork:
### THIS IS FOR GLASKLART MAINTAINERS DO NOT MODIFY THIS LINE OR WRITE BELOW IT. CONTRIBUTIONS AND COMMENTS SHOULD BE IN A SEPARATE COMMENT. ###

You're Done!

Finally hit 'Submit new issue' and we'll verify your request as soon as possible. (It should looks something like this [issue] (https://github.com/glasklart/hd/issues/1))

Thanks for helping to make Glasklart even more awesome!

Troubleshooting: Finding Blank iTunes IDs

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

Example

To view an example icon request with all the necessary information, view issue #1297.