Icon Packs

Smart Launcher supports the same icon pack format supported by most third-party launchers. However, there are a few tricks to get the best from your icon pack when used with Smart Launcher.

Start

If you don't have an icon pack yet, we suggest starting with an icon pack template like Blueprint. This will save you a lot of time and ensure that your icon pack is compatible with Smart Launcher.

Alternatively, you can follow one of the many tutorials available online. Then, just check to have these lines in your app manifest to ensure that Smart Launcher recognizes your icon pack.

<activity android:name="<...>" android:exported="true">
    <intent-filter>
        <action android:name="org.adw.launcher.THEMES" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

Advanced features

If your icon pack supports any of the advanced features listed below, they must be declared in your app manifest.

For each feature, you need to add an additional "category" tag.

Here's an example:

<activity android:name="<...>" android:exported="true">
    <intent-filter>
        <action android:name="org.adw.launcher.THEMES" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="INSERT HERE FEATURE TAG" />
    </intent-filter>
</activity>

---

Declare Material You support

org.icontheme.CHANGES_WITH_MATERIAL_YOU_COLORS

Enable this flag if icons in your icon pack reference Material Colors.

With the flag	Without the flag
When the wallpaper is changed, the icons will automatically update their color.	Your icons won't update when the wallpaper is changed.

Note: Enabling this flag does not automatically change the color of your icons based on the wallpaper. Instead, it informs the launcher about your theme's capability to take advantage of material colors. Misusing this flag may lead to significant performance issues, causing frequent icon refreshes without a valid reason.

Summary:

✅ Include this flag if Smart Launcher should reload the icon pack when the system palette changes. ❌ Don't include it if your icon pack wouldn't benefit from it, as it would only waste resources.

---

Specify custom Material Colors

By default, Smart Launcher tints monochrome icons using the same colors used by Pixel Launcher.

However, if you want Smart Launcher to use different colors you can instruct it to do so by declaring these two colors in your res/values file.

Note: These colors will be also used to tint fallback icons

<?xml version="1.0" encoding="utf-8"?>
<resources>
   ...
   <color name="org.icontheme.icon_background_color">@color/my_background_color</color>
   <color name="org.icontheme.icon_color">@color/my_foreground_color</color>
   ...
</resources>

When you define the colors	When you DON'T define the colors
All the icons will be tinted using the colors you choose.	Smart Launcher will pick the colors. If they don't match with colors in your icons, fallback icons may look different.

Summary:

✅ Specify the colors if you are using custom colors in your icons. ✅ Don't specify the colors if you are ok with the launcher picking the colors for you.

---

Fallback to Themed icons

org.icontheme.FALLBACK_TO_THEMED_ICON

Enable this flag to instruct the launcher to use Themed Icons for the icons not covered by your icon pack.

With the flag	Without the flag
Apps whose icons are not included in your icon pack will be skinned as Themed icons.	Apps whose icons are not included in your icon pack will retain their original appearance.

We recommend enabling this flag only if your icons have a visual appearance that complements Android 13 Themed Icons when mixed together.

Please note: In order for this to work, you must not provide in your theme any mask, back, overlay, scalefactor or icon shader.

Summary:

✅ Include this flag, unless you really believe unskinned icons looks better than the ones automatically created by Smart Launcher.

---

Ask our help

If your icon pack doesn't behave as you would expect, contact us at [email protected]. if your theme is not free, remember to include some promo codes.

This will allow the team to test your theme and ensure future versions of Smart Launcher won't break it. Also, we may feature some of the icon packs that work well with Smart Launcher on our social channels.