Tutorial Library
Setup, fixes and FAQ in one place
This page pulls the Discord FAQ knowledge base directly from the database and reformats it into a cleaner tutorial layout for the website.
Installation Issues
Before installation, please ensure your device is supported. Select the question you have about Installation.
How to Install the KLWP UI Theme?
How to Install the KLWP UI Theme
Step 1: Install Required Applications
Please install the following applications. You can find the download links in the Discord channel.
- KLWP Pro Key: Essential for using the KLWP Pro version.
- KLWP: Required for using the UI theme.
- Nova Launcher: Works best with the UI theme.
- UI Theme: The theme application.
Step 2: Nova Launcher Settings
- Open the Nova Launcher app.
- Customize the settings according to your preferences. We recommend downloading a desktop backup from our Discord server to quickly set up your desktop.
- Open Nova Desktop, scroll to the bottom, and tap the tick icon.
- Long-press on the desktop and tap Nova Settings.
- Click Home Screen and disable the Dock.
- Set Search bar placement to None.
- Ensure Wallpaper scrolling is enabled.
- Set Transition effect to None and Page indicator to None.
- Go back, use the search feature to find Force wallpaper scrolling, and enable it.
- Remove the desktop apps.
- Finally, set Nova Desktop as the default.
Step 3: Add Required Number of Desktop Screens (SILK UI)
Since the SILK UI theme requires four screens, please add screens until you have the required number.
Step 4: Set KLWP as Your Wallpaper
- Open KLWP.
- Follow the prompts to complete its requirements. Choose a folder as your working directory according to your preference.
- Once you've found your UI theme, click on it and wait for it to load.
- Grant the necessary permissions when prompted.
- Set it as your wallpaper. You may encounter some errors, but you can ignore them and set it as your wallpaper directly.
- Click the save icon.
- Return to your desktop and wait for it to load.
Tutorial Video: https://youtu.be/k39xdw6kQ7U?si=vDlre_l3hr7MJZ8m
How to Install the KLWP UI Theme Without Nova Launcher?
How to Install the KLWP UI Theme Without Nova Launcher
Step 1: Install Required Applications
Please install the following applications. You can find the download links in the Discord channel.
- KLWP Pro Key: Essential for using the KLWP Pro version.
- KLWP: Required for using the UI theme.
- KWGT Pro Key: Required for using KWGT widgets.
- KWGT: Required for using KWGT widgets.
- UI Theme: The theme application.
Step 2: Set Up KLWP Permissions
- Open KLWP.
- Turn on Autostart.
- Click on Permissions and turn on Dynamic wallpaper services.
- Change Battery saver to No restrictions.
Step 3: Set a Random Picture as Wallpaper (Xiaomi)
- Find a random picture and set it as wallpaper.
- Turn on Scrolling.
Step 4: Home Screen Settings (Xiaomi)
- Change the Home Screen to with app drawer.
- Turn off Place new apps on the Home screen.
- Turn off App vault.
- Turn off Home screen search bar.
- Turn on Don't show text.
- Remove all widgets and apps.
Step 5: Add Blank Widgets with KWGT
- Use KWGT to add blank widgets.
- Ensure the number of pages on your home screen matches the requirements of your UI theme.
- Add a blank widget for each page.
- Click on the widget and create it.
- Click on Touch to remove the action.
Step 6: Set Up KLWP
- Open KLWP and follow the prompts to set it up.
- Choose a folder to save data for KLWP.
- Click on the UI theme you have purchased.
- Click on Fix Now and turn on the required permissions.
- Set it as wallpaper.
- Turn on Use direct touch to enable button clicks on the bottom bar.
Tutorial Video: https://youtu.be/CFZAsHLZ2kw?si=RDYjMVdWI9LLomuD
Can I Download KLWP for Free?
We highly encourage supporting genuine software. However, if you need to download KLWP for free, you can use the following links
KLWP Pro Key Download: https://drive.google.com/file/d/1Dx_eu1VlyFVDfPkJAxJqPISWhRf-1lKV/view?usp=drivesdk
After installing KLWP Pro Key, please go to the Google Play Store to install KLWP. Thank you for your understanding and support.
UI Setup Issues
Select the question you have about UI Setup.
How to Change Wallpaper?
Change Wallpaper
- Open the KLWP application.
- Click on GLOBAL.
- Single-tap on the wallpaper folder (the path may vary in some UI).
- Choose your favorite wallpaper.
- Save.
How to Change Avatar?
Change Avatar
- Open the KLWP application.
- Click on GLOBAL.
- Click on Config > ... > Avatar.
- Choose the avatar you want to change.
- Save.
How to Change Username?
Change Username
- Open the KLWP application.
- Click on GLOBAL.
- Click on Config > ... > Username.
- Enter the new username you want to use.
- Save.
How to Change the Application Opened by Clicking the Button?
Change the Application Opened by Clicking the Button
- Open KLWP.
- Click on the shortcut.
- Click on the darker box (Click on the box on the right to view the button's location).
- Choose the application you want to open.
How to Change the Icon of a Click Button?
Change the Icon of a Click Button
- Open the KLWP application.
- Click on GLOBAL.
- Click on Config > Home Icon.
- Choose the Icon you want to change.
- Save.
How to Modify RSS Link?
Modify RSS Link
- Open KLWP.
- Click on Global.
- Click on Config > RSS.
- Enter your RSS links into each field.
- Save.
Can I Modify the Anime List to Make It My Own?
Modify the Anime List to Make It My Own
Anime data comes from Bilibili.
1. Make your watchlist, posts, and favorites public in the Bilibili settings.
2. Open the KLWP application.
3. Find and click on GLOBAL.
4. Path: Config > Bilibili > UID.
5. Enter only the numerical part of your UID, do not input any text.
Tutorial Video: https://www.bilibili.com/video/BV1EY4y1e7bL/?spm_id_from=333.999.0.0&vd_source=72e7abc1c643078b94808c078588a87f
Software Issues
Select the question you have about Software Issues.
What are the Supported Devices?
Supported Devices
Currently supported:
Xiaomi, Redmi, Vivo, Oppo, OnePlus, Realme, iQOO, Samsung, Red Magic, Nubia, etc.
Currently not available
Apple, all foldable screens, all tablets, Huawei, Honor.
Why Is My KLWP Theme So Laggy?
Some lower-performance smartphones may encounter this issue. Here are some solutions
- Use a lower version of KLWP.
- Uninstall the new version first before installing the old version.
KLWP v3.62 Download Link: https://kustom.rocks/download/KLWP/851
Why Does the Music Page of My KLWP Theme Have No Content?
- Ensure Kustom has access to Notifications (it should ask you when you save). To manually set/check, for most Android devices, go to your device’s settings » Apps » Overflow icon » Special access » Notification access.
- Start your music player at least once (Kustom detects automatically the player being used).
- Ensure the Player properly shows in the notification panel.
- If the album art doesn't work, ensure your player, like Poweramp for example, doesn't have the option to hide the cover in the lock screen or notification enabled.
- Try to reboot once, this sometimes is needed when Kustom is upgraded. In the worst case, you can also try reinstalling the app. In most cases, if the issue is only affecting a specific music player, this is related to the player not implementing Android standards. Usually, a test can be done with Google Music which is fully supported and compliant.
- Additionally, you can manually set your desired music player by going to app settings » General settings » Preferred Music Player.
Why Does the Weather Page of My KLWP Theme Have No Content?
- KLWP app requires enabling location permission.
- Check if your GPS is turned on.
- KLWP Settings > Location > Primary Location > Search for your city name or choose automatic.
- KLWP Settings > Weather > Force Update.
- Resave.
Touch or Launch App Not Working
On some devices, especially XIAOMI or ONEPLUS, touch or launch app might not be working. To fix this, please do the following
- Ensure Kustom and the Launcher are removed from battery optimization.
- Open Kustom settings, on the top select Notification Mode and then press FORCED. You can still hide the notification from android settings.
- Optional: Grant Kustom Notification access: from Android settings click Apps & Notifications -> Special App Access -> Notifications and grant access to Kustom app.
- You can also check Don't Kill My App: https://dontkillmyapp.com/ for more info depending on your device vendor.
XIAOMI
Also ensure this permission is set to yes: Apps > Permissions > Other permissions > KLWP > Settings > Home screen shortcuts SET TO YES.
POCO
Enable “Display pop-up windows while running in the background” on Apps > KLWP.
How Much Battery Does Kustom Use?
Short answer
Almost zero.
Long answer
Kustom is running only when you are looking at it and even when active it updates once every second so it's a lot different from standard live wallpapers which do 60 frame per second animations and sometimes also run in background. On top of that, Kustom will never update unless strictly necessary (if you are not scrolling or data is not changing). This of course applies to the wallpaper, the editor is a different story since it needs some CPU to show you the changes while doing them so it will use some battery if you edit your template a lot. If you want to have details on how it works, I suggest using BetterBatteryStats. You will then have detailed info on the battery usage of the wallpaper (org.kustom.service) and the editor (org.kustom.wallpaper).
Why Is My KLWP Theme Layout Messed Up?
Here are some solutions
a) Check if wallpaper scrolling is enabled
If you are using Nova Launcher:
Nova Settings > Home Screen > Wallpaper Scrolling > "On"
Nova Settings > Tap on the Search icon > Search for "Force Wallpaper Scrolling" > "On"
b) Verify the number of pages on your screen
Number of pages:
Dazzle UI: 5
Silk UI: 4
Zero UI: 2
Time UI: 5
Edge UI: 2 or more
Linkage Effect: 5
c) Restart your phone.
Other Issues
Select the question you have about Other Issues.
How can I get more KLWP themes?
All UI themes for MTheme can be found on this channel
https://ptb.discord.com/channels/1130424676078862400/1322481256012972124