LogoLogo
  • Support Center
  • Smart Launcher FAQ
    • Limited Access To Wallpaper
    • Introduction
    • Gestures
    • License and purchases
      • Problems and troubleshooting
      • Multiple Google accounts licensing issues
    • Update to Smart Launcher 6
    • Differences between versions
    • Tutorials
    • Glossary
    • Performances
    • False reports from Avast
    • Why is the experience with Google Discover sometimes unstable?
    • QuickSwitch support
    • Price of Smart Launcher
    • How Can I Support Smart Launcher?
  • Device specific issues
    • Google / Pixels
    • OnePlus
    • Samsung
    • Xiaomi / Redmi / Poco
    • Oppo / Realme
    • Huawei / Honor
    • Amazon Fire
    • Android TV Boxes
    • Apple / iPhone
  • Changelog
    • 6.5
    • 6.4
    • 6.3
    • 6.2
    • 6.1
    • 6.0
    • 5.5
    • 5.4
    • 5.3
    • 5.2
    • 5.1
    • 5.0
  • Troubleshooting
  • Work with Smart Launcher
    • Smart Launcher for Business
    • Icon Packs
    • KLWP/KWGT APIs
    • APIs For Third-Party Widget Developers
    • Join our team
    • Promo codes
  • Other products
    • Icon Pack Studio FAQ
      • Icon Pack Studio Launcher Support
        • Supported launchers
      • How to get the best experience with Icon Pack Studio
      • Documentation
        • Edit individual icons
        • Compositing options
      • Changelog
      • FAQ for launcher developers
      • FAQ for icon pack developers
      • Delete your Icon Pack Studio Account
    • Smart Launcher 3 FAQ
      • SL3 Notification plugin
    • Lock screens FAQ
  • Other Resources
    • Community
    • Blog
    • Privacy Policy
Powered by GitBook
On this page
  • Start
  • Advanced features
  • Declare Material You support
  • Specify custom Material Colors
  • Fallback to Themed icons
  • Ask our help

Was this helpful?

  1. Work with Smart Launcher

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.

PreviousSmart Launcher for BusinessNextKLWP/KWGT APIs

Last updated 1 month ago

Was this helpful?

Start

If you don't have an icon pack yet, we suggest starting with an icon pack template like . 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

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.

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

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

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.

Summary:

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


Ask our help

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.

Enable this flag if icons in your icon pack reference .

When the wallpaper is changed, the icons will automatically update their color.

Your icons won't update when the wallpaper is changed.

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.

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

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.

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

Blueprint
Material Colors
Themed Icons
dev-support@smartlauncher.net