KLWP/KWGT Integration
KLWP is a powerful app that lets you design your own dynamic live wallpapers. You can, e.g., add widgets or blur the wallpaper and add logic to change components depending on the external state. Niagara integrates with KLWP and publishes variables that allow you to react to specific events and conditions—read the following section for more information on how to use those.
✏️ Note: the same applies to the custom widget creator app KWGT, which is from the same team as KLWP and uses the same system. For brevity, we focus on KLWP in this guide.
Launch Niagara's Agenda From KLWP/KWGT
You can open Niagara Launcher's agenda sheet from KLWP/KWGT by using the open URL touch-action with the "URL" niagara://agenda.
Variables Published by Niagara Launcher
Niagara exports some variables to KLWP, which can generally be accessed in the formula editor with $br(niagara-launcher, variable-name)$
. Those variables can be of different types but are mostly numbers or boolean values (true/false). You can, for example, use them in a KLWP if statement comparing to a known value, like so: $if(br(niagara-launcher, variable-name) = "true", value if true, value if not true)$
. Make sure to include the quotation marks for "true"
/"false"
like in the example.
Current Screen
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:
Screen type | Variable value |
Favorites | 0 |
All apps list | 1 |
Other screens (e.g., search) | 2 |
Niagara is in the background (like on the lock screen or Android's recents screen) | -1 |
Calendar Events
Through the calendar-event
variable, you can check whether there are any calendar events visible below the clock/date in Niagara. When it's "true"
, a calendar event is currently visible in the favorites, and the Niagara widget thus takes up more space than normal. It's possible to combine it with the screen type variable to check if there is a calendar event and if the favorites are currently visible: $if(br(niagara-launcher, screen) = 0 & br(niagara-launcher, calendar-event) = "true", ..., ...)$
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): if(br(niagara-launcher, media-player) = "true", ..., ...)
.
Text and Theme Color
Niagara Launcher exposes the currently selected theme and home-screen text colors as variables theme-color
and text-color
, respectively. That is especially useful when those are set to adapt to the current wallpaper. As an example, you can set the color of a KLWP text element to $br(niagara-launcher, text-color)$
to match the rest of the interface.
Example: Blur Wallpaper and Hide Components in the App 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." This command checks if the favorites screen is visible (remember, the favorites screen has the value of zero) and sets the blur factor to zero (no blur) if it is and to fifty if it isn't. - 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 for elements placed above Niagara Launcher's favorites.
General KLWP Guides & Community
KLWP has an active development team and a highly supportive community. For more ideas, tips and tricks, please refer to the following resources: