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>

Material you colors

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.

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.

Dark mode

org.icontheme.CHANGES_WITH_DARK_MODE

Enable this flag if your icon pack incorporates different colors based on the UI mode (dark/light).

With the flag	Without the flag
Your icons will be refreshed when the dark mode is enabled or disabled.	Your icons won't be refreshed when the dark mode is enabled or disabled.

Note: Misusing this flag may result in performance issues, causing slower icon loading without a valid reason.

Ask our help

If your icon pack doesn't behave as you would expect, contact us at [e-mail]. 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.