KLWP/KWGT APIs

KLWP and KWGT are two apps by the Kustom team that let you create live wallpapers and custom widgets, perfectly complementing Smart Launcher.

Current status

At the moment there are no known issues between Smart Launcher and Kustom apps.

Our goal is to guaranteeing the best possible experience with Kustom apps, so if you have suggestions or request feel free to contact us.

Interacting with Smart Launcher from Kustom apps

Get the current Smart Launcher page

While using KLWP/KWGT you can check the current Smart Launcher page by using the formula $br(smartlauncher, screen)$ in the formula editor. Refer to the table below for the meaning of each code.

Screen name	Code
Default home page	0
Home page different from the default one	4
App page	1
Search page	2
News page	3

Get the launcher palette

Smart Launcher provides its color palette as variables, enabling you to create setups that seamlessly integrate with the launcher UI and widgets. For example, you can set the color of a KLWP text element to $br(smartlauncher, on-wallpaper-color)$ to ensure it fits perfectly with the rest of the interface.

Variable name	Explanation	Example
on-wallpaper-color	Used for items directly placed on the wallpaper. E.g: Icon labels
surface-color	Used to tint surfaces placed on the wallpaper. E.g. Widgets background
on-surface-color	Used for items placed on surfaces. E.g. Text in widgets (100%)
accent-color	Used for highlighted items. E.g. The category bar indicator

Please note that the variable names do not match the color names used in Smart Launcher. We chose these variable names to align with the naming convention adopted by the Niagara Team, aiming to create a unified experience for Kustom creators.