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.
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>
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>
org.icontheme.CHANGES_WITH_MATERIAL_YOU_COLORS
With the flag | Without the flag |
---|---|
![]() | ![]() |
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.
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 |
---|---|
![]() | ![]() |
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.
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 |
---|---|
![]() | ![]() |
Note: Misusing this flag may result in performance issues, causing slower icon loading without a valid reason.
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.
Last modified 1mo ago