Package selection guidance compiled from public package information, community data, and project usage.
A Flutter package that enables setting wallpapers on Android devices asynchronously, including support for video live wallpapers. It provides a simple and efficient way to change wallpapers from within a Flutter app without blocking the UI thread. The package is specifically designed for Android and integrates seamlessly with native Android APIs. It allows developers to enhance user experience by offering dynamic wallpaper customization options. The source code is publicly available on GitHub for transparency and contribution.
Use cases
Setting static wallpapers from app
Creating video live wallpapers
Enhancing personalization features
Background wallpaper updates
Integrating with photo gallery apps
Key features
Asynchronous wallpaper setting
Support for video live wallpapers
Android-only platform compatibility
Simple API integration
Non-blocking UI operations
Suitable for
Android app developers
Wallpaper customization apps
Photo and media apps
User experience enhancement projects
Apps requiring dynamic background changes
Considerations
Limited to Android platform
Requires runtime permissions
Video wallpaper support depends on device capabilities
May not work on all Android versions
Potential battery impact with video wallpapers
Original README
Original README snapshot from the linked source repository. Visit the repository for the latest content.
async_wallpaper
Flutter plugin to set wallpapers on Android and save them to Photos on iOS.
Static wallpaper from a URL, file path, content URI, or bytes
Home, lock, or both targets, with a separate result for each
Video and OpenGL live wallpapers
Scheduled wallpaper rotation
Capability checks before you show an action
Screenshots
Static wallpaper
Capabilities
More APIs
iOS
Video live wallpaper: home screen before, the system preview, and the applied video.
Scale modes:centerCrop, fitCenter, center, fill, and stretch on a 1080x2400 phone.
iOS: add NSPhotoLibraryAddUsageDescription to Info.plist.
Android 9 and older: declare WRITE_EXTERNAL_STORAGE with android:maxSdkVersion="28" and request it before you call downloadWallpaper.
Platform support
Android
iOS
Web/desktop
Static, live, OpenGL, rotation
Yes
unsupported
unsupported
Download
Yes
Yes
unsupported
Background work (for example WorkManager): use WallpaperApplyStrategy.direct. The cropper, picker, and live previews need a foreground Activity and return foregroundRequired otherwise.
The plugin shows no toasts and does not navigate. Your app shows its own UI from the result.