KLWP Integration

KLWP is an app that lets you design custom live wallpapers, e.g., to add widgets in the background or blur the wallpaper when you want. You can use variables in KLWP to change the design and other elements of the wallpaper on certain conditions - when you open Niagara's app list, for example.

Variables exported by Niagara

Niagara exports some variables to KLWP, which can generally be accessed in the formula editor with $br(niagara-launcher, <variable-name>)$ .

Read current screen type

To get the type of content currently shown in Niagara, you can read the screen variable exported to KLWP. It can have the following values:

List type	Variable value
Favorites	0
All apps list	1
Other lists (e.g., search)	2
Niagara is in the background (e.g., on Android's recents screen)	-1

Media player visibility

The variable media-player gives information about the current visibility of Niagara's media player widget. It's either "true" (when the player is visible) or "false" (when it's invisible). To use it in a KLWP formula with an if-clause, make sure to include the quotes, like so: if(br(niagara-launcher, media-player) = "true", x, y)

Example: How to blur wallpaper and hide components in all apps list

Go to the background tab, and change the type from solid to image, if necessary. Also, ensure you selected an image with the bitmap option.
Please scroll to the blur option in the same tab, tap on the checkbox next to it and enable formula support through the top right calculator icon.
Tap in the center of the blur option and paste the formula $if(br(niagara-launcher, screen) = 0, 0, 50)$ there. Afterward, tap on "apply."
Go to the layer tab and set the visibility option to the formula $if(br(niagara-launcher, screen) = 0, ALWAYS, NEVER)$ in a similar way. This will hide all the components you may have added in KLWP, like a clock, weather, etc.

Current Limitations

As of now, you can only interact with your KLWP live wallpaper with elements you placed above Niagara Launcher's favorites.