Godot Android Live Wallpaper 1.6.0 Tools 4.5 Community

Submitted by user oproject; MIT; 2025-09-24

Make your Godot Android app run as a live wallpaper in the background.

How to use:
- Keep (Ignore asset root) checked then click Install.
- (Recommended) Go to Project -> Reload Current Project.
- Go to Project -> Project settings -> Plugins.
- Enable LiveWallpaper plugin.
- Add LiveWallpaper node using the plus add-node button in the Scene tab.
- Before build, Go to Project -> Install Android Build Template.

Once the LiveWallpaper node has been added to the scene. You can:

reference it from any script and start live wallpaper service by calling start_live_wallpaper_service() method:
$LiveWallpaper.start_live_wallpaper_service()

Or connect to its signals by clicking connect from the Node tab then Signals. For example, connecting to signal visibility_changed(visibility:bool) to receive visibility updates, or from code as follows:
$LiveWallpaper.visibility_changed.connect(is_user_viewing_my_wallpaper)

Live Wallpaper settings:
A LiveWallpaper docked tab is going to show up next to Filesystem. From there you can set the wallpaper name and preview picture. The wallpaper name is going to show up in the live wallpaper picker, and the preview picture is going to show up as a thumbnail. Other metadata such as author and context URL are optional if you toggled show Info In Preview on.

Tip:
I recommend adding */Editor/* to your Project->Export->[Any Platform Preset]->Resources->Filter to exclude folders from project. This will prevent any assets inside a folder named Editor from being included in the Export including some Editor-only files from this plugin.