Table of Contents

  1. Copy in Files
  2. drawable.xml
  3. dashboard_drawable.xml
  4. appfilter.xml
  5. theme_resources.xml (NEW)


Copy in Files

First, you need to copy all of the PNGs for your icon pack into the /res/drawable-nodpi folder of Polar. You can remove the placeholder PNGs that are already in there initially. If you plan on using the home page, make sure you replace ic_web.png with a large version (preferably 512x512) version of your launcher icon.

Polar has file naming conventions which allow you to specify how the app's name will be displayed in the dashboard. Here are the rules:

  1. No changes: the first letter of the name will be capital.
  2. Single underscores: will become a space in the middle of a word, the next letter is capital. If it's placed at the beginning of the name, it makes the first letter lowercase.
  3. Double underscores: no space, makes the next letter capital.
  4. Triple underscores: makes the next word all capital.

Here are some samples:

  1. betternet.png will become Betternet
  2. google_chrome.png will become Google Chrome
  3. pay__pal.png will become PayPal
  4. _kaip.png will become kaip
  5. ___kaip.png will become KAIP
  6. ___npr_one.png will become NPR One
  7. material___os.png will become MaterialOS


drawable.xml

The drawable.xml file is located at /res/xml/drawable.xml and /assets/drawable.xml. You need to make sure they are both updated at all times! This file is used by launchers, and the dashboard to retrieve icons in your pack (along with categories they belong to).


dashboard_drawable.xml

This file is optional. If you want the dashboard UI to display different icons (or icons in a different order) than what you want to display to launchers, you can add a /res/xml/dashboard_drawable.xml file, which has the same structure as drawable.xml.


appfilter.xml

The appfilter.xml file is located at /res/xml/appfilter.xml and /assets/appfilter.xml. You need to make sure they are both updated at all times! This is the most important file for an icon pack. It's used by launchers to associate your PNGs with actual apps. This file can also be used to apply masks along with other various configurations. There are apps like ApplicationReader by Mike Penz which can aid in finding ComponentInfo for apps. But the most efficient way to get a list of ComponentInfos to put in your appfilter would be to use the Icon Request tool within Polar since it can do batch selection and email them to you.

theme_resources.xml (NEW)

The theme_resources.xml file is located at /res/xml/theme_resources.xml and /assets/theme_resources.xml. It's highly recommended that they are updated at all times (to avoid upsetting your users)!

This file is very similar to appfilter.xml, however it's vital to have support for LG Home. Like appfilter.xml, it contains icon-to-component associations, but it also contains info like wallpapers, theme previews, etc. which are used by LG Home.